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I. INTRODUCTION 


Tenex is a new time-sharing system, built around the DEC 
PDP-10 computer. This manual describes the first version of 
the Tenex Executive Lanquage, the primary vehicle’ through 
which users communicate and work with Tenex. 


Tenex offers the user three distinct facilities. First, 
Tenex contains a number of subsystems, entities eacn of 
which does a particular job. Some subsystems, such as 


Telcomp and BBN Lisp, provide complete computation services, 
are highly self-contained, and require little knowleuge of 
the remainder of Tenex or of the PDP-10 computer. Otner 
subsystems do specific jobs such as editing or compilation, 
are typically used togetner witn other subsystems, and 
require of the user more complete knowledge of Tenex. Tne 
properties and communication languages for the subsystems 
are contained in the separate subsystem manuals. 


Distinct from its subsystems, Tenex offers an entity, known 
as a virtual computer, that gives the user a vehicle for 
e ee . e ° , 
running machine language programs. This entity is termea a 
"computer" because it has all the appearance of a piece of 


computing harcware, "“virtual" because some of this 
appearance is in fact sunplie« by the system software that 
controls and drives Tenex. In particular, tne virtual 


Computer provides what appears to be more powerful core 
memory structure and input-output system than actually 
exists in the PNP-10 hardware. The language of tne Tenex 
virtual computer contains a subset of the PUP-1U0 machine 
language, together with a series of calls on the Tenex 
software system, known as "“JSYS's" and documented in_ the 
Tenex JSYS Manual. 


The third facility offered by Tenex is a file system tnat 
also provides access to and control over the various input 
and output devices in the system. Tenex files can ove _ kept 
on disk, magnetic tape, and Dectape. The paper tape reader 
and punch and the line printer are also treated as_ files, 
and Teletypes can, if desired, be accessed through the file 
system. The ARPA network connections also look like _ files 
to the user. This manual describes the Tenex file system in 
sufficient detail for most uses. More complete coverage of 
file structure is contained in the Tenex Technical Manual; 
access to files through Tenex machine lanquage programs is 
covered in the JSYS Manual. 


The Tenex Executive Lanquage allows the user to access and 
control these tnree facilities. The language consists of a 
series of commands that can be entered from Teletype or 
other keyboard terminals. In future versions of Tenex, it 
will also be possible to control Tenex operations through 
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commands stored in files, 


The next section of this manual discusses the structure of 

Tenex commands, and other conventions of the Executive 
Language. Subsequent sections describe separate groups of 
commands that provide access to the system, perform file and 
input/output functions, and provide access to the Tenex 
Subsystems. Following sections cover commands that provide 
program control and debugging, provide information about tne 
System, and communicate information about terminal 
characteristics to Tenex. 


This manual describes a preliminary version of the Tenex 
Executive Language. some of the sections noted above will 
have further commands in future versions, and these are 
described briefly at the end of each section. Some new 
groups of commands will also be added, and these are 
described at the end of the manual. 


A. SAMPLE DIALOGUE 


The following illustrates a typical dialogue with Tenex, 
involving the preparation and running of a user program. In 
the dialogue, characters, typed by the user are underlined; 
the remaining text is typed by Tenex. Carriage return is 
Snown by %, altmode by $. Comments to the right of the 
typescript explain tne action and reference manual sections 
where tne various Tenex commands are described in detail. 
Prior to the beginning of the dialoque, the user is assumed 
to have connected his terminal to the computer, either 
through the telephone system, or by direct patching. 


BEN TENEX 1.18.00 17-JAN-71 EXEC 1.22 


The user signals Tenex witn 
(CTRL)-C (II-A-1). Tenex 
responds with a Standard 
message. 


@LOGSIN (USER) JONES$ (PASSWORL) (ACCOUNT #) 114513 


JOB ON TTY24 21 JAN 71 16:52 


Tne user logs in to the system 
(III-B-1)., The @ character 
means Tenex awaits a command. 
Altmode causes Tenex to 
"recognize" (II-B-3) and type 
back certain portions of 
commands and arguments. 
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@COP$Y DTA2:ALPHA.MAC (TO) ALPHA.MAC; ,1 [NEW FILE}% 


@DEASSSTEGN DTA2Z:% ie 


IRSECTORY% 


ALPHA.MAC31 
BETA.MAC32 
~REL31 
@ 


@TEC$O.SAV;10% 
*5Y$ 
INPUT FILE: A$LPHA.MAC31% 


ei 


Having assigned (V-A-2) 
Dectape 2, the user copies a 
file from it onto the disk 
(1V-F-3), and then releases 
the Dectape (V-A-1). 


The user lists his file 
directory (III-F-1). Prior to 
loading ALPHA, the disk 
already contained two versions 
of file BETA. 


OUTPUT FILE: $ALPHA.MAC;2 [NEW VERSION)% 


AC 


@LIST$ (FILE) A$LPHA.MAC;2% 


The user calls in the TECO 
editing subsystem (VI-2). 
Using commands described in 
the TECO manual, he brings in 
the file previously copied to 
disk, and, after editing (not 
shown here) writes a new 
version (IV-A-5) onto the 
disk. (CTRL)-C returned 
control to Tenex. 


The user’ requests a line 
printer listing of the newly 
edited file (IV-F-15). 
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@MAC$CRO.SAV;7% 
*ALPHA<ALPHA% — 


*4C 
Q 


@LDR$.SAV;6% 
* 


@SAV$E 


@DIR$ECTORY% 


ALPHA.MAC;2,1 
~-REL31 
BETA.MAC;2 
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The MACRO-10 assembler (VI-4) 
is called in to produce a 
relocatable binary version of 
ALPHA. Tenex will 
automatically assign a .REL 
extension (IV-An4) to the 
Output file. Messages typed 
by MACRO were omitted for 
Clarity. As before, (CTRL)-C 
forced a return to Tenex. 


The user calls in the LOR 
Subsystem (VI-€) to link- load 
the binary versions of ALPHA 
and BETA into Tenex core. 


(loader messages were 
omitted). The loader returns 
control automatically to 
Tenex., | 


(CORE FROM) $20 (TO) $777777 (ON) & 
PROG.SAV;1 [NEW FILE]% 


All assigned core memory is 
saved (VII-A-1) in file PROG. 


The program is Started 
(VII-A-7) 
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»REL31 
PROG.SAV;1 
@ 


@DEL$ETE ASLPHA.M$AC31% 


@LOGO$UTS 
KTLLED JOB 4,USER JONES, ACCT 
USED 0:3:21 IN 0:59:46 
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Subsequent to the program run, 
a second directory listing 
confirms three new files - 
ALPHA.MAC;2 (created through 
TECO, ALPHA.REL3;1 (created by 
MACRO), and PROG.SAV31 
(created by the SAVE command). 


The first, now obsolete, 
version of ALPHA is deleted 
(IV-F-8). 


11451, TTY 24 AT 1/21/71 17:52 


Finally, the user’ logs. out 
(III-B-2). Tenex types a 
final message that informs the 
user,among other things, that 
he has used 3 minutes, 21 
seconds of CPU time during a 
session that lasted 59 
minutes, 46 seconds. 
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II. EXECUTIVE LANGUAGE STRUCTURE 


Communication with Tenex takes the form of a dialogue in 
which the user gives a command, Tenex performs the desired 
action, and then waits for a new command. The collection of 
available commands, together with certain special characters 
and conventions, makes up what is known as the Tenex 
Executive Language. This section describes the general form 
of the language; subsequent sections cover the individual 
commands. 


A. SIGNALING TENEX 


1. (CTRL)-C 


To signal Tenex hold down the control (CTRL) key and strike 
ol Daas At the beginning of a session (CTRL)-C will get the 
initial attention of Tenex. Tenex will respond witn an 
identifying message followed by the "@" character on the 
next line: 


BBN-TENEX 1.11.00 7-OCT-70 EXEC 1.09 


The code numbers in the message identify the version of 
Tenex in use and will change as the system develops over 
time. At this point the user can LOGIN as described in 
Section [II-Be-l. 


After initial contact has been established, (CTRL)-C will 
continue to get Tenex's attention during the ensuing 
session. During a session, Tenex will respond to (CTRL)-C 
by typing "+C", followed by "@" on the next line. For 
brevity, the abbreviation #+C has been used for (CTRL)-C 
throughout the remainder of this manual. 


Tenex will respond to tC no matter what is happening at’ the 
time, Thus, +C will interrupt a running program or file 
Operation, abort a partially typed or partially executed 
Tenex command, and in all cases control will return to 
Tenex. 


The only partial exception to this rule occurs when +4C is 
Struck during output on the user's teletype. Tenex will 
continue the output until the user's output buffer* is empty 
before responding to a single +¢#C, but will respond 
immediately to a second tC. 
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2. @ - The Tenex Ready Symbol 


The "@" typed after +C indicates that Tenex is ready for a 
new command. Tenex will also type “@" on completion of a 
command, or after aborting a command with one of the editing 
characters discussed in II-C below. 


B. TENEX COMMAND STRUCTURE 


1, Command Components 


Tenex commands are made up of three components: keywords, 
arguments, and+-noise words. Each command begins with an 
imtial keyword that identifies its main function; it may 
contain further keywords that select options. Arguments, 
such as user or file designators, core addresses, or account 
numbers tell what a command is to act on, or provide values 
for use in command execution. Noise words (always enclosed 
in parentheses) make Tenex commands more understandable to 
the user, but have no effect on command execution. In the 
following examples, keywords are indicated by K, arguments 
by A, and noise words by N. 


@ CHANGE (ACCOUNT # TO) 123456 
K N A 
@ AVAILABLE LINES 
K K 


@ RENAME (EXISTING FILE) ABC.FOO;1 (TO BE) ALPHA.A3;1 
K N A N A 


2. Command Fields 


For purposes of the following discussion it is convenient to 
think of Tenex commands as split up into fields. Each 
keyword or argument that the user must specify begins a 
field; the field runs up to the next keyword or argument or 
to the end of the command. Thus, a Tenex field contains one 
argument or one keyword, followed possibly by one or more 
Noise words. The value of a command field is taken to be 
the particular choice of keyword or argument that begins it. 
The three commands shown above are repeated below with 
vertical lines showing their breakup into fields. 


*The output buffer is a holding area within Tenex' where 
Characters are stored prior to transmission to the user's 
teletype. 
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@ lcHANGE (AccouNT # T0)| 123456 | 
@ |AVAILABLE|LINES | 
@ RENAME (EXISTING FILE) |ABC.F00;1 (TO BE){ALPHA.A31 


The values of the three fields in the last example are 
RENAME, ABC.FO0;1, and ALPHA.A3;1 respectively. 


3. Command Input and Recognition 


Tenex allows three styles of input. They can be’ intermixed 
freely within a command with a separate style applied, if 
desired, to each field. 


ae Full Input. The user can type any field in its 
entirety, spelling out fully the keyword or argument and the 
noise words (if any) with their enclosing parentheses. This 
style is laborious, but "safe" for the user not yet sure of 
the language. 


The following two input styles apply to fields that begin 
with keywords. Depending on the circumstances (as described 
below) they may apply in part or in full to fields that 
begin with arguments. 


b. Abbreviated Input. The user can omit the noise words 
altogether from a Tenex command field. He can shorten the 
keyword by typing at least enough initial characters 
(terminated by space) to distinguish it from the other 
keywords acceptable in that context. If the user” enters 
insufficient characters for unique identification, Tenex 
will type "?" and abort the command. Entering more than the 
minimum abbreviation is perfectly acceptable. This mode 
allows experienced users to type commands very concisely. 


c. Recognition Input. The user can enter initial keyword 
characters as above, but terminate with altmode* instead of 
Space. In this event Tenex will type back the remainder of 
the keyword together with any immediately following noise 
words - i.e., everything through the end of the current 
field. Recognition input is helpful to less than fully 
experienced users because the material typed by Tenex 
verifies that the intended command has been given and also 
supplies clues as to what is expected next. (The ? feature, 
VIII-1, is also helpful in feeling one's way through a Tenex 
command. ) 


* "ESC" on some teletypes 
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With altmode, insufficient characters cause much less 
trouble. Tenex merely rings the teletype bell and waits for 
more tnput. As above, more than the minimum characters are 
perfectly acceptable. 


Terminating input at any point in a field beyond the minimum 
required for recognition will cause Tenex to type back the 
rest of the field. This is true even when input stops, say, 
midway through a noise word, and is useful, for example, 
when the user wants to enter keywords in full but wishes 
Tenex to supply noise words for clarity. 


With certain frequently used keywords, fewer than the 
minimum characters are accepted by convention in either 
Abbreviated or Recognition input. These are cited as they 
occur. An example is LOG which is taken to mean LOGIN even 
though LOGOUT also begins with LOG. 


The following examples show full, abbreviated and 
recognition input as applied to a command field. In these 
and all foliowing examples user input is underlined, and 
altmode is indicated by "$", (The "$" is not printed by 
Tenex.) 


Full: RENAME (EXISTING FILE) 
Abbreviated: RE 
Recognition: RESNAME (EXISTING FILE) 


d. Argument Input. Tenex arguments cannot be abbreviated. 
However any noise words in the field with an argument can be 
omitted. Thus, the user can partially abbreviate argument 
fields by typing the argument in full (terminated by space) 
and then proceeding immediately to the next field. 


In certain cases, Tenex will perform recognition as 
described above on arguments. Whether or not’ this is 
possible depends on the argument and the context. For 
example, account numbers are never recognized, user names 
are recognized in some contexts, and certain parts of file 
designators are always recognized. The various cases of 
argument recognition are cited individually as they occur in 
the following sections. In particular, file designators 
have their own set of recognition rules, described in detail 
in section IV-B. Whether or not an argument is recognized, 
one can always have Tenex supply the noise words of an 
argument field by typing the argument in full and 
terminating with altmode. 


The following examples show the three styles of input as 
applied to a field that begins with a file designator. 
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Fulldls ABC.FO0O;1 (TO BE) 
Partially Abbreviated: 


Recognition: ABSC. FOO; 1 (TO BE) 


4. Command Terminators 


Space, altmode, and carriage return can terminate commands, 
though Carriage return is the standard Tenex command 
terminator. In the general case, once all fields of a 
command have been entered (and any "recognized" information 
typed back) Tenex will await a final, confirming carriage 
return before executing the command. There are the 
following exceptions: 


a. C.R. Terminates Last Field. With most commands, Tenex 
will begin execution immediately if the user terminates the 
last field with carriage return instead of space or altmode. 
As with space or altmode enough characters must have been 
entered to identify the keyword or argument; as with space, 
the remainder of the field is not typed back. 


b. Confirming C.R. Needed. Some commands, notably those 
that change or destroy information always require a final 
Carriage return, even if carriage return ended the last 
field. The carriage return that terminates such a field is 
echoed as space. With these commands, Tenex reminds’ the 
user that final confirmation is needed by typing a message 
in square brackets after the last field is entered. 


c. No Terminator Needed. With certain "harmless" commands, 
Such as queries about the system, no terminator is required; 
Tenex will take action as soon as the last field is entered. 


d. Subcommands To Follow. Certain Tenex commands can_ be 
followed by optional sSubcommands (see 7 below). Typing 
comma before a terminating carriage return indicates’ that 
subcommands are to follow. 


5. Examples 


The following examples illustrate some o f the 
characteristics of Tenex command structure, recognition, and 
termination. Carriage return is indicated by "%"3; as before 


user input is underlined and altmode is indicated by "S$", 


@AVAILABLE LINES 
@AV L 
@AVSAILABLE L$INES 
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The above are equivalent and represent full, abbreviated, 
and recognition input as applied to both fields of the 
command. This system query requires no confirmation; 
execution would begin after the final space in the first two 
examples, the final altmode in the third. 


@AV$AILABLE D$EVICES 
@AV L$INES 
@AVSATLABLE D_ 

@AV LINES 


The AVAILABLE command has two options; LINES or DEVICES as 
Selected by the second keyword. As indicated above L or D 
is enough for Tenex to determine which option was’ intended. 
Also, these examples show some combinations of different 
input styles within a single command. 


@CHSANGE (ACCOUNT # TO) 12345 % 
@CH 12345% ais 


This command requires a confirming carriage return which can 
follow the last field (first example) or terminate the last 
field (second example). The argument “account number" 
cannot be recognized; it must always be entered in full. 


@REN$AME (EXISTING FILE) AB$C.FOO31 (TO BE) 
= ALPHA.A3;1 [NEW FILE] % 


@REN ABC.FOO;1 ALPHA.A;1% [NEW FILE] % 


RENAME requires a final confirming carriage return 
regardless of how the last field was terminated (space in 
the first example, carriage return in the second). In the 
first example recognition style input was used to enter the 
first two fields. In the second example abbreviated input 
was used to enter the first field, which began with a 
keyword. Abbreviation is never possible with arguments, 
however, even those that can be recognized. Consequently 
the argument ABC.FO03;1 was entered in full (it could also 
have been recognized). It was possible, however, to proceed 
immediately to the iast field ALPHA.A3;1, omitting the noise 
words (TO BE). 


6. Default Values and Null Values. 

a. Default Values. With certain command fields, Tenex sets 
aside a default value to be supplied automatically if the 
user declines to specify a particular value himself. For 
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example, in the AVAILABLE command, LINES is the default 
value for the second field. There are two ways to trigger 
the selection of default values. Entering altmode as the 
first character of a field will cause Tenex to select and 
print the field's default value, togetner with any following 
noise words. 


Where more than one defaultable field occurs in a command, 
these fields are generally grouped together at the end of 
the command. Entering carriage return as the first 
Character of a field will cause Tenex to default it and any 
Succeeding defaultable fields, but without printing further 
information. Terminating a field with carriage return will 
default any further defaultable fields. In either of these 
cases Tenex behaves as though the carriage return terminated 
the last field: if the command can be executed without a 
final carriage return, Tenex will proceed to do so. The 
following four examples are all equivalent: 


@AV$AILABLE L$INES 
@AVSAILABLE $LINES 
@AVSAILABLE % 
CAV 


b. Null Values. Sometimes a reasonable choice for field 
value is no value at all, for example in the case of 
selecting none of several possible options. Tenex allows 
for this situation by provicing for null values. Wull is 


indicated by the character "-", To enter a null value for a 
field, type "-" followed by one of the usual field 
terminators (space, altmode, or carriage return). 


Subsequent interaction with Tenex will take place as though 
an ordinary field value nad been entered. 


Generally, when null is one of the possible choices for a 
field, it will also be the default value, and can be 
selected by any of the default mechanisms described above. 
When a field is defaulted to null by carriage return, 
nothing is printed. When defaulted by altmode, "=" is 
printed followed by any noise words, 


The following examples illustrate a command* with three 
fields following the initial keyword field, each of which 
has null as a default value. In the first case, eacn of the 
fields has been given a definite value; the other cases show 
various ways of nulling one or more of the fields in 
question. 


*The DETACH command as shown here is not’ fully implemented 
in the 1/23/71 version of Tenex. 
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The Tenex Executive language provides a number of options 
for enhancing and controlling the appearance of Tenex 
commands. The main intent of these is to assist in future 
versions of the system, when it will be possible to "drive" 
Tenex with pre-typed commands stored in Tenex files, but the 
options can be used at present with directly executed 
commands. 


a. Comments. A comment can be added to a Tenex command by 
typing "3" instead of carriage return after completing the 
last field. Text typed at this point will appear in the 
typescript, but will not affect command execution. 
Terminating the comment with carriage return will cause 
execution to begin. 


@CH$ANGE (ACCOUNT #T0) 21345;MONEY LOSING OVERHEAD% 


b. Spaces and Tabs. Wherever the context will permit (in 
particular before or after keywords or arguments) Spaces and 
tabs* can be inserted into Tenex commands without affecting 
command execution, abbreviation or recognition. 


@ CH$ANGE (ACCOUNT # TO) 15432 sCONSULTING? 


c. Continuation. .A command can be continued on the next 
line by typing "&" wherever space is legal (except not in 
terminating a file designator). Tenex will type a_ carriage 
return, and the user Can continue typing the command on the 
next line. 


@RENSAME (EXISTING FILE) AB$C.FOO;1 (TO BE) & 
ALPHA.A;1 [NEW FILE] % 


d. Form Feed. Form feed (typed by (CTRL)-L and abbreviated 
+L.) “can be used as a substitute for carriage return. This 
will advance the teletype paper to the top of a new page 


prior to command execution. 


e. Lower Case Letters. Lower case lJetters, when available 
on a tenex terminal, may be substituted freely for upper 
case letters in typing Tenex commands. 


*Commands relevant to tabulation are described in_ section 
IX. On model 33 teletypes (CTRL)-I will cause program 
driven tabulation, with tab stops adjustable through the 
STOPS command. 
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C. EDITING AND ERRORS IN TENEX COMMANDS 


Occasionally the user will make typographical or other 
errors in typing a Tenex command. To deal with these 
Situations, Tenex provides a number of special characters 
that allow the user to edit commands as he types them in. 
In addition, Tenex itself checks commands for Syntactic 
errors, erroneous keywords or arguments, and system 
conditions that would prevent command execution. If the 
user fails to correct an error of this sort in time, Tenex 
will type a message, and take action appropriate to the 
error in question. 


As the user types a command, Tenex continuously monitors the 
Incoming character stream, decoding each keyword or argument 
as soon as the user terminates it. This has the benefit of 
allowing Tenex to detect and cope with errors as soon as 
they are made. On the other hand it restricts the user's 
ability to edit a partially typed Tenex command. In 
particular, once a keyword or argument* has been terminated 
(with space, altmode, or carriage return), it is no longer 
available for modification. The result of this restriction 
is to limit the range of the Tenex editing characters, as 
noted in the descriptions that follow. 


1. (CTRL)-A 


To delete a character, type (CTRL)-A (abbreviated +A). 
Tenex will type "\" followed by the character deleted. 
Successive tA's will delete successive characters back to 
the beginning of the keyword, argument, or noise word group 
that one is currently typing. 


However, +A cannot delete back into a previous field, Ors. VF 
one is typing noise words, back into the preceding argument 
or keyword. In addition, with multiple element arguments 
such as file designators, +A will delete back to the 
beginning of the current element but no further. In all of 
these cases, typing too many tA's will cause Tenex to ring 
the teletype bell, but take no further action. 


@AB+BVSAILABLEXDEVNVNENODLSINES 


In the above, +A was struck before each appearance of \. 


*or any one element in a multi-element argument. 
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2. (CTRL)-W 


To delete all of the keyword, argument (or argument element) 
Or noise word groups that one is currently typing, strike 
(CTRL)-W (+W). Tenex will type "+", Typing +W is exactly 
like typing as many +A‘s as are =TJlegal in the current 
context. Consequently, one can never type more than one +W 
in a row; an attempt to do so will ring the teletype bell. 


@ABAIL<AVAILSABLE DCVICE<DEVICES 


3. (CTRL)-R 


Occasionally, too much editing will so foul up the 
typescript that one can no longer tell what it means. To 
take care of this, (CTRL)-R (+R) typed anywhere in a 
command, will cause Tenex to carriage return, and then 
retype the command with all editing carried out, up to. the 
point where +R was struck. , 


@CHX\XANHENE\HGE (AC X\XC+ACCP\P 
CHANGE (ACCOUNT # TO) 12245\5\4\2 
CHANGE (ACCOUNT # TO) 12345% 


+R was typed at the end of each of the first two lines. 


4. (CTRL)-X, Rubout 


Typing (CTRL)-X (+X) or Rubout at any point in a command 
will delete the entire command. This is useful, for 
example, when one has made an error that can no _ Tlonger. be 
got at with tA or +W. +X and Rubout have exactly the same 
effect except that with the former Tenex types "#X"3 with 
the latter "XXX". 


@REDSIRECT (INFILE) +X 
@RENSAME (EXISTING FILE) XYZ.F00;5$ (TO BE) XXX 
@RENSAME (EXISTING FILE) ABC.FOO;I$ (TO BE) ALPHA.A3;1% 


5. Errors 


Once aetected, Tenex has two ways of dealing with errors. 
In a few cases, Tenex will type "?" after an erroneous 
command element and allow the user another try at making a 
correct entry. This happens, for example, when a supposedly 
existing file cannot be found, or when some other character 
is struck instead of a confirming carriage return. Errors 
of this sort are designated “Type 2" errors in this manual. 
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@RENSAME (EXISTING FILE) XYZ. ? ABC.F0031 
~ (TO BE) ALPHA.AsS1 P72 


In the above, the user's first mistake was to enter a 
nonexistent file name - XYZ. (Note that Tenex picked this 
up even before he had typed the rest of the file 
designator.) His second mistake was to type "P" instead of 
the confirming carriage return that Tenex expected. In each 
case Tenex typed "?" and gave him a second chance. 


In the more typical case Tenex will deal with errors’ by 
typing "?" or a specific error message, aborting the entire 
command line, and awaiting a fresh command on the next line. 


@AVSAILABLE XYZ$ ? 
@ 


@STS$ART | 
NO PROGRAM 
@ 


In each of these examples Tenex rejected the entire command. 
In the first case the user specified a non-existent keyword; 
in the second, conditions in the system prevented command 


execution. 


For each command or group of commands in this manual a_ list 
of error messages is given. Where the message is simply 
"2". the error condition(s) leading up to it are spelled 
out. Type 2 errors are labelled as such. | 


In addition, there are many Syntax errors such as incorrect 
keyword or wrong confirmation that apply to all commands. 
Most of these type ? and then either give the user a_ second 
chance or return to command input. 


In a few cases, due to the developmental nature of Tenex, 
unanticipated command errors will yield obscure, 
Systems-oriented messages from deep within the Tenex 
monitor. Typical of these are: 


ILLEGAL INSTRUCTION TRAP IN EXEC 
(numbers and further message) 


JSYS ERROR RETURN IN EXEC 
(further message) 


These errors will abort the offending command and return to 
command input. If possible, they should be reported to 
Tenex systems personnel. 
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D. FORMAT CONVENTIONS IN MANUAL DESCRIPTIONS 


Throughout the remainder of this manual, commands are shown 
as though entered with recognition input, i.e., the full 
command is spelled out with the minimum input characters 
underlined. For clarity, $ has been omitted in almost all 
cases, but the user should assume that altmode was struck at 
the end of the underlined portion of each keyword. Ina few 
cases altmode is shown (by $) to highlight special 
recognition situations. Carriage return is shown by %, 


The structure of each command is first spelled out fully, 
with all options shown. Arguments are named in lower case. 
Where there is a choice of keywords or arguments within a 
command the possibilities are all listed, separated by slash 
marks and sometimes enclosed in square brackets, with the 
default choice listed first. When null is a choice, it is 
indicated by "-", In the examples that follow each command 
description, everything is in upper case as it would be in a 
real typescript, and there are no extraneous’ brackets. or 
Slash marks. 


Command descriptions: 


@AVAILAGLE [LINES/DEVICES}] 
@CHANGE (ACCOUNT # TO) account # % 


Command examples: 


@AVAILABLE LINES 
@CHANGE (ACCOUNT # TO) 12345% 
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ITI. SYSTEM ACCESS 


The commands described in this section allow the user. to 
enter and leave Tenex, change the account that will receive 
charges during a session, and to release and reestablish 
teletype terminal control over a job. In addition, this 
Section discusses user names and passwords, the Tenex 
identifiers for system users; accounts, the mechanism by 
which Tenex accumulates use charges; and jobs, the mechanism 
through which users do work with Tenex. 


A. GENERAL INFORMATION 


1. User Names 


Each Tenex user places on file at the computer center a 
name, which can be any string of letters and digits of his 
choice, up to 39 characters long. Surnames are ae_e typical 
choice. A user's name serves as his prime identifier to the 
Tenex system. It must be given when he logs into’ the 
system. In addition, user names assist in file sharing (see 
Files) and message sending between users. 


2. Passwords 


Because user names are generally known to the community of 
Tenex users, an additional mechanism is needed to safeguard 
privacy. To this end, each user files with the computer 
center a password, again a string of up to 39 letters and 
digits of his choice. Passwords are generally kept secret; 
unless the user wishes otherwise, only he and Tenex systems 
personnel will know his password. 


Like user name, password must be given when the user logs in 
to the system. To preserve password secrecy full duplex* 
terminals do not echo when a user types his password, and 


*Full duplex means that the terminal's keyboard and typing 
head are completely disconnected. Striking a key sends a 
Character to the computer but has no effect on the typing 
head. For a character to be printed, it must be sent from 
the computer. Normally, Tenex “echoes back" the characters 
it receives; to preserve password privacy requires merely 
that this echo be suppressed. 


*spuomssed puenbajes 03 BAOGe paqltudsap ud0lL4Ie 9YW 
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B. ACCESS COMMANDS 


1. LOGIN 


To gain entry to Tenex: 


@LOGIN (USER) user name (PASSWORD) * (ACCOUNT) account names 
TMESSAGE] | 


or 


@LOGIN (USER) user name 
(PASSWORD) 
S$ZABS%F*9(())+@+EGH>>XY?22?2?"#E=L0)'( (SST 
(ACCOUNT) account name % 
[MESSAGE] 


The first form applies to full duplex terminals. The 
asterisk indicates that the user is to type his password 
here, but that no echo will return. The second form applies 
to half duplex terminals. Here Tenex types carriage return 
on termination of the user name, and password fields, and 
right after the noise word (PASSWORD). The gibberish 
characters are just that, the mask supplied by Tenex_ to 
disguise the user's’ password. Users with full duplex 
terminals can invoke a modification of the second LOGIN form 
(without mask characters) by terminating the LOGIN, user 
name, and/or password fields with carriage return. This 
places each argument on aie separate line, and allows for 
unusually long user or account names. 


Both command forms shown above apply to users free to use 
account names. § With users restricted to account numbers, 
Tenex types "(ACCOUNT #)" instead of "(ACCOUNT)" and accepts 
only a decimal number of the required form. 


After a successful LOGIN, Tenex responds with a_e standard 
message giving the TSS Job Number assigned, the computer 
line number, and the date and time of entry, (in the’ form 
hour:min). In addition, Tenex:’ may print a system LOGIN 
message, entered by the operator, that gives the latest 
information on system schedules, new features and the like. 


Tenex will print a system message, if one exists, only if it 
was entered more recently than the user's last LOGIN, or if 
the user has not logged in for eight hours. Otherwise,’ the 
user is assumed to have seen it recently. A user not 
wishing to see the system message may abort it by typing +C 
during its output. A user wishing to see the most recent 
system message may do so at any time by TYPEing the _ file 
<SYSTEM>LOGINMESSAGE which copies this file to nis teletype 
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(see IV-F-16). 


In addition to the standard and system messages, one user 
may leave a message for another by filing it under the name 
MESSAGE.TXT;1 (see IV-A) in the second user's directory. If 
such a file exists when a user logs in, Tenex will type “YOU 
HAVE A MESSAGE" when Login is complete. The user may then 
see the message by TYPEing MESSAGE.TXT31. 


Examples: 


@LOGIN (USER) SMITH (PASSWORD) (ACCOUNT #) 114512 
JOB 6 ON LINE 25 13-APR-70 12:34 


Here, a user restricted to account numbers entered on a full 
duplex terminal at 12:34 p.m., on April 13, 1970, and was 
assigned Job 6 and line 25. | 


@LOGIN (USER) JONES 

(PASSWORD) 

DIDIOQURU12343AUNS9Z ,CSDHD123845JID73F 3SK0-:23$$%%5".'9 
(ACCOUNT) ADMINISTRATIVE 

JOB 2 ON LINE 13 13-APR-70 9:03 


This user entered on a half duplex terminal at 9:03 in the 
morning. He specified an account name and was assignea Job 


@LOGIN (USER) EXCEPTIONALLYLONGUSERNAME% 

“TPASSWORD)% 
(ACCOUNT) UNUSALLY COMPLE XACCOUNTDESIGNATOR% 
JOB 4 ON LINE 17 12-MAY-70 1056  — 


Because of their length, this user terminated the arguments 
with carriage return. 


Errors: YOU ARE ALREADY LOGGED IN 
"2" after user name if no such user 
"2" after password if incorrect 
"2" after account if must be numeric but isn't 


Notes: 


LOGIN is usually the first command a user will give after 
gaining Tenex's initial attention with +C (see II-A-1). 
Generally the facilities and commands of Tenex are 
inaccessible until a user has loaged in. There are three 
exceptions. Certain system queries may be used to obtain 
information about the system prior to LOGIN. These are 
noted with their individual descriptions in section VIII. 
The terminal characteristics and tab stop commands described 
in section IX can be used at any time tc communicate’ the 
nature of the user's terminal to Tenex. The ATTACH commana 
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described below can be used prior to LOGIN to regain control 
over a DETACHED Job. 


AutoLogout: If, after typing an initial +C€ to Tenex the 
user fails to LOGIN within a reasonable time, Tenex will 
drop him from further attention through the Autologout 
function. Upon completion Tenex will type a message similar 
to the standard LOGOUT message below, giving the elapsed and 
CPU times consumed. After an Autologout the user can once 
again initiate discourse with Tenex by typing +C. 


2. LOGOUT 


To leave the system: 
@LOGOUTS 


LOGOUT closes any currently open files, clears the user's 
Job, and returns it to tne available Job pool. After this 
has been done, Tenex types a message indicating the job and 
user logged out, the current account and computer line, and 
the time of LOGOUT. Following this, Tenex types the central 
processor and connected time, in the format hours:min:sec. 
At this point, if connection was over telephone lines, Tenex 
hangs up its end of the connection. Use charges cease at 
the moment the user types the terminating carriage return. 


Example: 


@LOGOUTS 
KILLED JOB 6, USER SMITH, ACCT 11451, TTY 25, AT 14:56:34 
USED 0:0:4 IN 0:21:25 


Errors: NOT LOGGED IN 


3. CHANGE — 

To change accounts for subsequent computer use charges: 
@CHANGE (ACCOUNT TO) account name% 
or 
@CHANGE (ACCOUNT # TO) account number’ 


This command allows the user to switch computer use cnarges 
from one account to another during the course of a working 
session. The format depends on whether the user can use 
account names or is limited to numbers. Use charges begin 
accruing to the new account on termination of the command, 
and continue to do so until LOGOUT or a subsequent CHANGE 
command. 
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Examples: 
@CHANGE (ACCOUNT TO) OVERHEADS 
@CHANGE (ACCOUNT # TO) 12345% 


Errors: "2" Tf account must be numeric but isn't. 
4, DETACH 


Occasionally the user may wish to initiate a Tenex job, 
start it running, and then disconnect his terminal from it. 
This would save unnecessary telephone charges, for example, 
when a lengthy processing operation was started from a 
distant teletype, or permit a user to use his terminal for 
other purposes while his job ran to completion. The Tenex 
DETACH command makes this possible; its format is: 


@DETACH (INFILE) [-/existing file designator] (OUTFILE) 
[-/file designator] (AND) [-/START/REENTER/CONTINUE] 


The INFILE and OUTFILE arguments specify files that will 
take the place of the user's teletype once the DETACH 
operation is complete. If the job requests teletype input 
it will come instead from INFILE; any teletype output will 
be sent to OUTFILE. See IV-A for the format for typing file 
designators. The START, REENTER and CONTINUE keywords 
permit starting a user program or subsystem that may have 
been loaded into core prior to DETACH. Their action is 
identical to the STAPT, REENTER and CONTINUE commands 
described in VII-A-6,7,&. 


If INFILE and OUTFILE are given, but no program is_ started 
up, then Tenex will seek further Executive commands from 
INFILE. If a program is started, then any teletype input or 
output it generates will affect INFILE and OUTFILE. If a 
program is started in the absence of INFILE and QOUTFILE all 
will proceed normally. until a request for teletype input or 
output occurs, at which point the job will go into a dormant 
State. If no arguments are specified the job will go 
dormant immediately, since Tenex will immediately request, 
but find no source for, executive commands. 


In the 1/23/71 version of Tenex, the INFILE and OUTFILE 
options are unavailable; these fields must be nulled. This 
limits the uses of DETACH to the last two cases described 
above. However, this can still be useful when one wishes to 
Start a lengthy processing operation known not to request 
teletype input or output, or to preserve temporarily an 
elaborate job structure. 
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Examples: The following illustrate the two options 
currently available with DETACH. 


@DETS | 
@DETACH (INFILE) $- (OUTFILE) $- (AND) START% 


In the first example the users job will remain dormant until 
Subsequent reconnection through the ATTACH command below. 
In the second example any processing triggered by the START 
option will take place, after wnich the job will become 
dormant. 


Errors: error in file name (" ? ") 
error in opening file 
errors .in START/REENTER/CONTINUE: see same, 


5. ATTACH 
To regain control over a DETACHed job: 


@ATTACH (USER) user name (PASSWORD) * (TSS JOB #) 
job number % or $ 


The asterisk indicates that the password is not echoed. on 
full duplex terminals. With half duplex terminals Tenex 
provides a modified format. similar to LOGIN. Tne TSS Job 
Number specifies the Job to be ATTACHed to; it is tne Job 
Number that was assigned when that Job was first logged in. 
If the Job Number field is defaulted, Tenex will select the 
DETACHed job belonging to this user if exactly one such job 
exists. 


ATTACH can be given without logging in, since the user is 
re-establishing control over an already loggea in Job. If 
the user is logged in at the time of an ATTACH command, his 
current job is automatically DETACHed, and Tenex types the 
message "DETACHING JOB n". 


If the ATTACHed-to job was running at the time of ATTACH, it 
continues doing so. If dormant due to lack of teletype 
input, it comes back to life. 

Example: 


@ATTACH (USER) JONES (PASSWORD) (TSS JOB #) 2% 
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Errors: 


"2" after user if no such user 
THAT'S A FILES=ONLY DIRECTORY NAME 
"2" after password if incorrect and 
current job is not logged in 
JOB n NOT DETACHED 
JOB n NOT LOGGED IN 
JOB n NOT LOGGED IN UNDER name 
NO DETACHED JOB LOGGED IN UNDER name 
TSS JOB # REQUIRED - name HAS 
MORE THAN ONE DETACHED JOB 
INCORRECT PASSWORD (if logged in) 
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IV. TENEX FILE SYSTEM 


The Tenex file system provides two facilities. First, Tenex 
files provide a means for storing and retrieving information 
over and above the use of core memory during a_ working 
session. JTenex files can be kept on disk, Dectape, ordinary 
magnetic tape, or paper tape. Files stored on these media 
can contain any information that Tenex is capable of 
handling. 


In addition to this conventional use of files as a storage 
medium, Tenex file commands give the user access. to 
input/output devices not usually associated with files. For 
example, the line printer and the user's teletype can both 
be treated as files, the one Capable of receiving 
information, the other capable of receiving or supplying it. 
This treatment of input/output devices as files unifies and 
Simplifies the moving and storing of information in Tenex. 
Often, a single Tenex file command can perform input = and 
output as well as file manipulation, depending on the 
arguments given it. : 


Executive commands discussed in this section, togetner with 
commands in the various subsystems, give tne user control 
over his files. They allow him to create and destroy files, 
Specify where in the system they are to be kept, make copies 
of them, and cause them to be output. 


A, TENEX FILE DESIGHNATORS 


In order to bring an executive command to bear on a_ file, 
one must identify the file in question by giving its Tenex 
file designator. Depending on circumstances, a Tenex file 
designator may contain up to five* file descriptors tnat 
Specify the file's name, the device it is to be sent to or 
taken from, and certain other characteristics. With all 


five descriptors included, a Tenex file desiqnator has the 
following form: 


device:<directory name>file name.extension;version number 


Underlined characters in the above are typed literally. 
Other characters define the five descriptors that make up a 
file designator. The paragraphs that follow explain. the 
meaning and syntax of the file descriptors. In practice, of 
course, file designators appear as arguments to Tenex 


*Additional optional file descriptors, applicable only to 
disk files are covered in IV-C. 
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executive commands. This means that the entire designator, 
taken together should be terminated with space, alt mode, or 
carriage return, depending on its position in a eTenex 
‘command and the Tenex rules for abbreviation and file 
designator recognition. 


1. Device 


Tenex keeps separate track of files stored on separate 
devices. Consequently, in dealing with a Tenex file, one 
must specify the device it is to be taken from or’ sent to. 
Tenex devices are designated by device codes (usually three 
or four letter abbreviations), and to specify a device, one 
must type its code, followed by a terminating colon. With 
devices such as Dectapes, magnetic tape units, and 
teletypes, Tenex may have available more than one unit. In 
this situation, a unit number must be appended to the device 
code, e.g., MTA3:, TTY27:. However, the user's teletype can 
always be referred to as just TTY:. 


Tenex cannot perform recognition on device codes, and when a 
code is specified it must be typed in full. However, if the 
user omits the device altogether from a Tenex file 
designator (by starting with directory or file name), Tenex 
will assume (but not type) the default value disk (DSK:). 


In addition to its ordinary storage and input-output 
devices, Tenex has a unique ecological stabilizer, NIL, 
which has no physical embodiment but serves as a drain 
capable of absorbing limitless amounts of unwanted 
information. Files written onto NIL simply disappear 
without trace, never to be seen again. No obsolescing data 
is left behind to pollute Tenex or the external environment. 
NIL can also be viewed as a write only memory. 


Tenex devices and their codes are listed below. 


DEVICE CODE 
Disk DSK: 
Magnetic tape units MTA1l:=-MTA7: 
Dectape units DTA1:~-DTA7: 
User's teletype TTY: 
Specific teletype lines JTIY0O:-TTY37: 
Line printer LPs 
Paper tape reader PTR: 
Paper tape punch PTP: 
Disposal NIL: 


When accessing disk, magnetic tape, or Dectape files, 
additional descriptors are needed to identify the particular 
file intended. The remaining devices, however, serve as 
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Sources or Sinks for unnamed information, and with these 
devices the device code alone constitutes a complete file 
designator. For example 


PTR: 


Serves aS a complete designator for any file to be input via 
the paper tape reader, and 


LPT: 


completely specifies the line printer as a destination. 


2. Directory name 


Files stored on the Tenex disk are grouped into file 
directories, each desiqnated by a directory name. Eacn 
registered Tenex user has one "primary" directory with a 
directory name identical to his user name; he may also have 
additional file directories bearing other directory names. 
A Tenex user can access the files in any of his directories, 
and if authorized*, files in the directories of other users 
as well. 


At any moment in time, a Tenex user is "connected" to a 
given file directory. When he first logs into the system, 
connection is automatically establisned to his orimary 
directory. At any time the user can establish connection to 
another directory, his own or someone else's, through the 
CONNECT command described in IV-E-13 below. In accessing a 
file in the directory to which he is connected, the user Gan 
omit directory name from the file desiqnator. Tenex will 
assume (but not print) the connected directory name as a 
default value. To access files in other directories, tne 
user has two options. He can shift connection to the 
desired directory (through CONNECT) and then proceed as 
above. Alternately, he can name the directory in question 
as part of the file designator. In this case, he accesses 
the desired file, but remains connected to the original 
directory for future file reference. 


Directory names begin and end with opening and closing angle 
brackets: 


<SMITH> 
<JONES> 


*Access to disk files is controlled through an_ optional 
descriptor that specifies protection status, as discussed in 
Section IV-C-2 below. 
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Tenex will perform recognition on a directory name if a 
partially typed name is terminated by altmode or +#+F.* In 
recognizing the directory name, of course, Tenex checks a 
list of all mames currently registered. Consequently the 
number of characters needed for recognition of a particular 
name will depend on the Tenex installation, and may vary 
over time, 


Files stored on Dectapes or magnetic tapes are also. kept 
track of through directories, but each Dectape or magnetic 
tape has just one unnamed directory that lists all the files 
it contains. Consequently, directory name is meaningless, 
and need not be supplied in designating files stored on 
Dectape or magnetic tape. 


3. File Name 


Every disk, Dectape, or magnetic tape file carries a name 
given to it at the time of its creation. A file's name 
serves as the primary handle for gaining access to it. A 
Tenex file name can be any combination of letters and digits 
up to 39 characters long (6 characters for Dectape). The 
following are legitimate Tenex file names: | 


] 
A 
VERYLONGFILENAME 


As with directory names, Tenex will recognize file names 
when they are terminated with altmode or +F. In recognizing 
file names, Tenex looks only at the directory in which’ the 
file resides. Consequently, the user has control over name 
recognition in his own directory(s) and, by judicious use of 
initial characters can construct file names that require 
little input for recognition. For example, by using a 
different TIiVSE Character each time, the user could 
construct up to 36 file names each recognizable after one 
character of input. 


4. Extension 


Frequently it is desirabie to create several files with the 
Same file name, containing perhaps related information or 
different transformations of the same information. Tenex 
file extensions make tnis possible with disk, Dectape, and 
magnetic tape files by modifying the file names they follow, 
and distinguishing between separate files with a common 
name. For example: 

*Section IV-B-3 explains file designator recognition in 
detail. 
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ALPHA.F4 
ALPHA.REL 
ALPHA.SAV 


might designate symbolic, relocatable binary, and core image 
versions of the program contained in file ALPHA. 


Tenex file extensions consist of a period, followed by = any 
combination of up to 39 letters and digits (3 with Dectape). 
Although Tenex regards all disk, magnetic and Dectape files 
as having extensions, the user can specify a null extension 
(one having no characters), by typing just the initial 
period. 


A | 
WEXTENSIVEXTENSION 


Tenex will recognize file extensions, limiting its search to 
the extensions associated witn the current file name. If a 
null extension is present, Tenex will recognize it when’ tne 
user types no extension characters at all, i.e., if he types 
altmode or +F at the beginning of the extension field. 


The user can freely invent file extensions and use them for 
any desired purpose. However, for convenience, Tenex 
Subsystems recagnize a Standard collection of file 
extensions, each of which specifies a certain type of data. 
In many cases subsystems will select’ the appropriate 
extension when an input file name is given, = and 
automatically supply the standard extension when creating 
output files. The standard extensions are listed below. 


EXTenSIoOn MEANING RELEVAHT SULSYSTES- 
~ MAC a MACRO-1ld 
Source program MACRO-10 
Pegae a TELCOMP-ITI 
program or data TELCOMP 214 
~BAS a BASIC program BASIC 
~F4 a FORTRAN IV 
source program FORTRAH IV 
oREL a relocatable FORTRAN IV 
object program MACRO#1u, LOADER 
SAV an executable FORTRAN IV 
object program MACRO-lu, 
(core image) DDT 
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5. Version Number 


Tenex version numbers carry the idea of file extensions one 
Step further, and put it to use for a different purpose. 
Version numbers are available only with files stored on the 
disk; they allow one to create multiple disk files with the 
Same combination of file name and extension. The intent of 
version numbers is to keep track of successive, modified 
versions of a single file, For example, 


ALPHA.F431 
ALPHA. F452 
ALPHA.F433 


might indicate three successive versions of FORTRAN IV 
source program, ALPHA.F4;, each differing somewhat from the 
one before. 


In the above, 31, 32, and 33 are Tenex file version numbers. 
Tenex version numbers consist of a semicolon followed by a 
decimal integer between 1 and 256. Within this range the 
user can freely specify version numbers when creating Tenex 
files. Tenex does not "recognize" version numbers jin_ the 
sense used In this manual. However, if the user omits 
version number from a disk file designator (by typing space 
or altmode after the file extension), Tenex will pick a 
default value according to the following rules. 


1. If this is the creation of a new file (as indicated 
by new name.extension;), Tenex assigns 1. 

2. If this file is to be read from storage, Tenex 
selects the highest-numbered version. 

3. If the file is to be written onto storage, Tenex 
assigns a number one greater’ than’ the highest 
existing number. 

4, If the file is to be deleted, Tenex picks’ the 
lowest numbered version. 


In reading from storage, Tenex complains if a user-specified 
version is not found. In writing, if the indicated version 
is already present, the new information’ replaces the 
information already in the file. If the user enters O as 
version number, Tenex will supply (but not type) the highest 
existing number. This is useful, for example, when one has 
forgotten the current highest version, but wishes to avoid 
creating successive versions under rule 3 above. 


Although version numbers can exist anywhere in the allowable 
range, each user is restricted as to how many versions he 
can keep of any one file. This restriction is controlled by 
an allotment number assigned to the user when he registers 
with the system; it can be changed, if desired, by the 
system operators. The restriction works as follows. If the 
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user exceeds his allotment by creating a new file version, 
then the earliest existing version (in terms of date and 
time last written) is automatically deleted by Tenex. For 
example, if the user's allotment were 3 and whe wrote 
versions 327, 316, and 343 of a given file on successive 
days, then writing a new version would cause version 27 to 
disappear. Note that the restriction has nothing to do with 
the order of version numbers, only the order in which files 
were written (although frequently the two will coincide). 


B. TYPING FILE DESIGNATORS 


The five part structure of Tenex file designators reflects 
the convenience and uniformity of the Tenex file system, 
most of which would be lost if the user had to enter all 
five descriptors every time he accessed a file. Tenex 
avoids this pitfall by three mechanisms alluded to in_ the 
foregoing discussion. First, some descriptors are relevant 
only to certain files and need not be sunnlied with others. 
second, in other situations, Tenex will Supply default 
values for relevant descriptors omitted by the user. Third, 
Tenex will apply recognition to some of the file 
descriptors, 


1. Relevant Descriptors 


All five descriptors are relevant to disk files. With other 
files, only some of the descriptors apnly. Thus, as shown 
below, many Tenex files can be specified by abbreviated 
versions of the full file designator. 


DEVICE NAME APPLICABLE FILE DESCRIPTORS 


DSK: device name:<directory name> 
file name.extension;version 


MTA1:-MTA7: device name: file name.extension 
DTA1:-DTA7: 


TTY: 

TTYO:-TTY37: 

LPT: device name: 
PTR: 

NIL: 
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2. Default Values 


Tenex will supply default values for device name, directory 
name, and version number. Device name defaults to DSK:, 
directory name and version number are relevant only to disk 
files. Thus the general default capability permits 
abbreviated versions of disk files as summarized below. 


DESCRIPTOR DEFAULT VALUE 

device name: DSK: 

<directory name> currently connected directory 
file name. j — s#2=- 

extension; 9 ss#<-= 

version see detailed rules (IV-A-5) 


Thus, in many situations, the user need only specify file 
name and extension to designate a disk file. In addition to 
the general default capability summarized above, with 
certain file commands Tenex will default file name and/or 
extension, These situations are described as they arise. 


3. Recognition 


As discussed separately in preceding sections, fTenex will 
recognize directory name, file name and extension. Unlike 
the situation with command recognition, the user has_ two 
ways of triggering recognition with file descriptors - 
altmode or +F. Otherwise, descriptor recognition is similar 
to command recognition; the user must type sufficient 
characters to determine a match. With insufficient 
Characters Tenex rings the teletype bell and awaits further 
input. With unrecognizable input, Tenex types a question 
mark and allows the user to try again. 


If the input is recognized, further action depends on, 
whether the user terminated with +F or altmode. In either 
case, Tenex types the remainder of the descriptor, including 
the character >, ., or 3 aS appropriate. With +F, Tenex now 
pauses to allow the user to enter the next descriptor. With 
altmode, Tenex attempts to determine all remaining 
descriptors, applving recognition to file name and 
extension, the default rules described previously to version 
number. Tenex types each descriptor successfully 
determined; it pauses and rings the teletype bell on 


S 


IV, TENEX FILE SYSTEM Page 35 


encountering any descriptor it can't determine. 


Unexpected results can occur unless the user keeps in mind 
that Tenex will recognize a null extension in the absence of 
Specific input. For example, if one triggers file name 
recognition by altmode, Tenex will select a null extension 
associated witn that name even though there may be otner 
extensions. Tenex will also select a file name or extension 
witnout specific input if it 1s uniquely specified. For 
example, if a given directory contains just one file, then 
terminating the directory name with altmode will cause Tenex 
to select the file in question. 


4, Examples 


The net effect of the rules and conventions outlined above 
is to reduce the amount of typing required in specifying 
Tenex files. Assume that Dectape 1 contains: 


ALPHA.ABC 
BETA. XYZ 


and that the disk contains: 


<SMITH>ALPHA.AEC;1 
<JONES>ALPHA.ABC31 
<JONES>BETA. 31 

<JONES>BETA.XYZ31 
<JONES>BETA. XYZ 32 


then with user JOHES typing, the following would be complete 
Tenex file designators. 


LPT: 

{IL: 
DTA1:A$SLPHA.ABC 
<SSMITH>ALPHA. ALC31 
ASLPHA.ABC31 
BSETA. 31 
BeFETA.X$YZ32 
BtFETA.X+FYZ31 


— 


CO™~Y CO CI & GW PO pe 
ee? Mee? Nt Manet ge? gt Met Meee 


Examples 1 and 2 are device names that form complete file 
designators. Example 3 illustrates the tnree-part structure 
of a Dectanpe file designator, and also Shows name 
recognition triggered by altmode. Wote that Tenex selected 
the only extension present. In example 4, device name 
defaulted to disk. Also, user SMITH has but one file in his 
directory, so terminating his name with altmode caused 
automatic selection of the last three descriptors. 
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In the remaining examples device name and directory name 
have both defaulted, the latter taking on the value JONES. 
In example 5, the entire file was recognizable after tne 
first character of its name. Example 6 shows a case where 
altmode triqgered selection of the null extension, even 
though others were present. In example 7, +F was used to 
terminate BETA, so that extenston XYZ could be selected. 
This example assumes the file was to be read from the disk; 
version 2 was selected according to the default rules 
described previously. In example 8 the extension was 
terminated with +F so that version 1 of the same file could 
be selected by hand. | 


C. MULTIPLE FILE DESIGNATORS 


Certain Tenex commands can address several files at one 
time. For example, one can APPEND a series of files onto an 
existing file, or DELETE several files in one operation. In 
cases where more than one file is legal, there are two ways 
to enter multiple file designators. 


1, File Designator Lists 


One can list a series of file designators separated by 
commas: 


DTA1;ALPHA.ABC;1, BETA. 31,<SMITH>ALPHA.ABC;1 


After the first designator, name and extension default’ to 
those in the preceding designator (but other descriptors do 
not). With some commands one can terminate a_ file 
designator with Space or altmode before typing the 
separating comma; with others, the comma itself must 
terminate all designators but the last. In the latter case, 
only +F can be used to trigger recognition or defaulting, 
Since altmode might prematurely terminate the entire list. 
Assuming a command of the second kind, the following 
illustrates the defaulting of file name and extension: 


B+FETA.31,+FBETA.XYZ31,+FBETA.4FXYZ 32 
The first tF triggered recognition of name BETA. The second 
and third defaulted name to its previous value, while the 
fourth defaulted extension to XYZ. 
2. The * Feature (not implemented in 1/23/71 Tenex) 


As a Second way of designating multiple files, one can enter 
"*" in place of directory name, file name, extension, or 
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version number. When used this way, * means "all existing 
values of". Assuming the disk files of IV-B-4, and with 
Jones typing: 


Example Files Accessed 

PKL All files in connected directory 
with extension .XYZ, that is: 
BETA. XYZ31 
BETA. XYZ32 

BETA.*31 All files in connected directory 
named BETA and with version 1: 
BETA. 31 
BETA.XYZ31 

<*>ALPHA. ABC | All ALPHA.ABC's in any directory: 


<SMITH>ALPHA.ABC31 
<JONES>ALPHA.ABC31 


<SMITH>*.*;% All files in directory <SMITH>: 
<SMITH> ALPHA.ABC31. 


When the version is omitted (as in the first and _ third 
examples above), which version is selected depends on the 
Tenex command. Some commands will select all_ versions, 
others the highest existing version. 


When multiple file designators are legal, they can be 
specified by a list of files, by the * feature, or by a 
mixture of the two. For example, the following would 
Specify all Jones's .XYZ files together with ALPHA.ABC;1: 


*.XYZ3*, A$LPHA.ABC31 


When processing multiple file designators, Tenex types the 
Separate designators for the files actually accessed. This 
is particularly useful in verifying Tenex's interpretation 
of any *'s that may have been given. 
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D. OPTIONAL DISK FILE DESCRIPTORS 


In addition to the five principal file descriptors which 
serve mainly to identify and organize files, there are three 
optional descriptors, available only with disk files that 
can be used to establish file properties. Through these 
descriptors, one can establish the protection status of a 
file and the account to be charged for storing it, or one 
can declare the file to be temporary. 


These descriptors need not be supplied in designating a 
file; Tenex will always assume default values. However with 
optional descriptors included, the complete file designator 
for a Tenex disk file takes on the following, rather 
horrendous form. 


DSK:<directory name>file name.extension;version number 
313Pprotection status ;Aaccount 


The format for the three optional descriptors is similar: 
each begins with a semicolon followed by the letter T, P, or 
A to indicate which descriptor is intended. Because’ they 
are identified by their leading characters, these 
descriptors can be entered in any order relative to. each 
other (all must follow the five main descriptors). However, 
as discussed below, if the descriptor ;T is entered, then 
neither protection status nor account can be specified. 
Tenex performs no recognition on these descriptors; if 
entered at all they must be entered completely. The meaning 
of these descriptors is spelled out below. 


1. Temporary Files 


On creating a new file, one can declare it to be _ temporary 
by entering ;T after the main descriptors. A temporary file 
will be deleted automatically by Tenex when the user’ logs 
out, Temporary disk files are useful for such things as 
testing programs, or collecting data for listing on the line 
printer or later transfer into permanent files. Any disk 
file can be declared temporary, but a temporary file can be 
given neither special protection nor account status; Tenex 
will automatically supply the default values described below 
for these descriptors. If the 3;T descriptor is omitted from 
a file designator, Tenex will treat it as an _ ordinary, 
permanent file. 


2. File Protection 
In general, one can apply any Tenex file command to any disk 


file, no matter who it belongs to as long as one can specify 
the descriptors that make up its file designator. 
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Furthermore, even when one's knowledge of these descriptors 
is incomplete, Tenex can help fill in the gaps through its 
recognition and default value features. Thus, by its 
nature, Tenex proviues avery general file sharing 
capability. This leads to an equally general neeu for some 
way of protecting files from unauthorized access. 


To this end, Tenex provides a file protection mechanism, 
exactly balancing its file sharing capability. File 
protection is controlled by a six digit octal number 
assiaqned to each file at the time of its creation. This 
number breaks down into three fields, iagentical in format, 
each of which can be regarded as containina two octal digits 
or six binary bits. The bits in any one of these fields 
control the following aspects of file protection. 


FILE PROTECTION FIELD 
BO Bl BO  B3 84 Bd 


©) 


Bit Protection Aspect Controlled 
BO Read contents of file 

Bl Write onto file 

B2 Execute program storec in file 
B3 Append to file 

B4 List file in directory listing 
B5 Not useG 


setting a bit 1 permits the indicated action; setting it QO 
denies the action. Read allows information to be extracted 
from a file; write permits new information to be written 
onto a file, replacing part or all of the oriqinal contents. 
Execute allows a file that has been read into core memory to 
be executed as a program. Any file can be made executable 
in this sense; what happens when one tries to start 
execution, of course, depends on what the file actually 
contained. Append ailows new information to be added to the 
end of a file. List determines whether or not the file will 
appear when the directory containing it is tabulated. The 
remaining bit is unused and can take on either value with no 
effect. 


Taking these six bits as a two diait octal number, = some 
common values are: 77, which permits full access; 52, which 
protects a file from modification, but’ permits other 
functions; ana O00 which denies evervthing, keeping even the 
file's existence a secret. 


As mentioned above, a full, six digit file protection number 
contains three of these protection fielas, arranged as 
follows: 
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FILE PROTECTION NUMBER 
self group others 


Working from left to right the three fields control access 
to the file by successively larger groups of users. Self 
protection governs one's own access to ae “file. Limiting 
one's own access permits one to protect valuable information 
from inadvertent destruction, or to protect a file from 
modification by a possibly faulty program. 


Tenex provides a mechanism whereby users can form groups for 
the purpose of file sharing. This is useful, for example, 
where several users are collaborating on a common 
programming job and wish to share the files they are 
creating. The file group mechanism works as follows. Each 
group is assigned a number. For each user, Tenex records a 
series of these numbers indicating what groups he_ belongs 
to. Likewise, for each file directory, Tenex' records 
numbers indicating which groups have access to the files it 
contains. Thus a given user can belong to a number of 
groups. He can make each of his’ directories available to 
one or more groups, which may or may not coincide with the 
groups he belongs to. The assignment of group numbers’ to 
users and to file directories is done by the Tenex system 
operators. 


The second field in a file protection number governs’ the 
powers granted when the file is accessed through the group 
mechanism. If a group member designates a file in a 
directory available to his group but belonging to another 
user, it is this protection field that controls the kind of 
access granted him. 


The third protection field governs the access granted to 
users approaching the file from outside the group mechanism, 
i.e., all “other" users. In a typical situation, the three 
protection fields might specify successively more stringent 

rotection. For example a user might grant full access to 

imself, read, execute, and list access to group members, 
and list only access to others, yielding 3;P775202 as 
protection descriptor. 


If a user omits protection number when creating a disk file, 
Tenex will assign a default value, presently 777752. This 
grants full access to the user and group members, read, 
execute and list access to others. 


3. Account 
On creating a disk file, the user can specify the account to 


be charged for its subsequent storage. Depending on his 
Status with respect to account information (as described 
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under System Access, section III-A-3) the user will be 
required to specify an account number of five Or six decimal 
digits, or permitted to enter an account name of up to 39 
letters and digits. For example 


3A11451 
sAOVERHEAD 


would be legitimate account descriptors for the two classes 

of users, If the user fails to specify an account 
descriptor, Tenex will assign the account name or number 
currently in force (as determined by the LOGIN (III-B-1) or 

CHANGE (III-B-3) commands). The user can Change the account 
(f sie th a file is charged through the CHANGE command 
IV-F-6)., 


A, Examples 


In the following, new disk files are created with the 
optional descriptors applied. * 


ALPHA.ABC323T 
ALPHA, ABC;33A12345 3P775202 


Here a temporary version of ALPHA.ABC was first created. It 
will disappear when the user logs out. Next, an ordinary 
(permanent) version was created, to be charged to account 
12345, and carrying protection status 775202, 


E, FILE DESIGNATOR ERRORS 


Some or all of the following errors apply to every command 
containing a file designator argument: 


) "2" Gf file not found and existing file required 
(type 2). 

) NO JFH'S AVAILABLE: You MUST CLOSE SOME FILES FIRST 
) JSB FULL: TRY CLOSING SOME FILES THEN REPEATING 
COMMAND 

4) DIRECTORY FULL: CAN'T CREATE NEW FILES UNTIL Yau 
DELETE SOME FILES AND "EXPUNGE (DELETED FILES)" 

) NEW FILE NAME REQUIRED 

) device: IS NOT MOUNTED 

) device: IS ASSIGNED To JOB n 


*Depending on how the files were created these desiqnators 
might require less typing than the amount shown. For 
example, the COPY command (IV-E-3) will Supply default 
values for extension and version, and sometimes for file 
name, 
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8) READ PROTECT VIOLATION FOR FILE name 
9) WRITE PROTECT VIOLATION FOR FILE name 
10) FILE name BUSY 

11) BAD USE OF * 

12) NO FILES IN THAT DIRECTORY 


These error messages have the following meaning. 


1) Tenex expected the user to designate an existing file, 
but can find no file matching the desiaqnator actually typed. 


2) Before a file can be manipulated (read, written, appended 
to, etc.) it must be opened. Each time a file is opened, it 
is assigned a Job File umber, and each user job nas 
available a limited pool of these numbers. After 
manipulation, an open file is normally closed, and its JFN 
returned to the free pool. Files can be opened by user 
programs, and various other mechanisms within Tenex, and can 
be kept open as long as necessary. In addition, many Tenex 
File commands must open the file(s) designated by the user 
as a first step in performing the action indicated. (When 
the action is complete the file is automatically closed.) 
When a File command must open a file, but finds no JFN 
available, this message is typed. The user can list the 
assigned JFN's with FILSTAT (VIII-8) and then free up one or 
more of them through SHUT or JFNCLOSE (IV-F-11,12). 


3) For each job, Tenex maintains a Job Storage Block (JSB) 
to contain miscellaneous status information necessary for 
running the system. Among other things, the JSb contains 
data on each open file. When a Tenex File command attempts 
to open a file but finds the JSB full, this message is 
typed. Closing one or more files by SHUT or JFNCLOSE will 
probably free up enough space in the JSB to open a new file. 


4) Each disk file directory has a limit, established by the 
system operators, on the number of files it can hold. When 
this limit is reached, attempts to create new files will 
yield the error message shown, Removing files from the 
directory through DELETE followed by EXPUNGE (IV-F-7,9) will 
free up space for new files. 


5) The user designated an existing file in a context where a 
new file was required. 


6,7) Prior to accessing a Dectape or magnetic tape unit, or 
the paper tape reader, the user must reserve the device in 
question for his exclusive use through one of the device 
handling commands described in detail in Chapter V. An 
attempt to access one of these devices without first 
reserving it will yield one of the error messages shown. 
Message 6 will also result if one tries to access a Dectape 
drive with no tape, or the line printer when it is off line. 
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8,9) The attempted access violated the read or write 
protection status (IV-C-2) of the specified file. 


10) The Tenex command has attempted to open a file that is 
already open. The file may have been opened by another job, 
or due to an error or program interruption it may be held 
open by the user's job, 


11) * was used in a context where a file group (IV-C-2) 
cannot be desiqnated. This message also occurs if the user 
attempts to use * as an ordinary character is ae file 
descriptor. 


12) * was given for name, extension, or version with a 
directory that contains no files. | 


F, FILE COMMANDS 


The Tenex executive commands described below list’ the 
contents of file directories; move files within the system, 
and to and from input/output devices; change file names’ and 
file properties and destroy anc revive files. Additional 
commands, described in Section VII, create files from 
information contained in Tenex core memory, and load these 
files back into core. 


1. DIRECTORY 
To obtain information about files: 


Q@DIRECTORY [device:] [<directory name>] 
[file name.extensionsversion] % or ,% 


The three arguments are optional. Omitting them altogether 
leads to a tabulation of the disk directory to which the 
user 18 connected, By the selective use of the arguments 
DIRECTORY can be made to tabulate a disk directory other 
than the connected one, the directory for a device other 
than the disk, or information about a particular file. For 
example: 


@DIRECTORYS all files in the 
connectea directory 

@DIRECTORY <SMITH>% all files in directory 
geet as 


@DIRECTORY DTA1:% all files on Dectape 1 
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@DIRECTORY <$SMITH>ALPHA.FO031% just the selected file 


In the 1/23/71 version of Tenex, the only combinations 
allowed are a disk file directory, a single disk file, or 
the entire directory for a Dectape. 


DIRECTORY can tabulate a variety of information about files 
in several different formats. The format and_ the 
information listed are controlled by a series of optional 
Sub-commands that modify the action of DIRECTORY. In the 
absence of subcommands, DIRECTORY types, on a Separate line 
for each file, the name, extension, and version number of 
each file selected by the arguments given. Files are listed 
alphabetically. Where two or more files have the same name, 
only extension and version number are typed for files after 
the first. Where there are several versions of a file, 
version numbers are typed on one line, separated by commas 
and following the file name and extension. In the case of 
temporary files, Tenex types ;T after the version number. 
To obtain a listing of this sort, terminate DIRECTORY with 
carriage return. In the following examples, user Jones is 
connected to his primary directory. 


@DIRECTORY% 


ALPHA.ABC31 
BETA. 4,1 

eav Lec et 
@ 


To modify DIRECTORY with sub-commands, terminate with 
comma-carriage return. Tenex will type "“@@" and await 
Subcommand input. Certain subcommands allow additional 
keyword fields to specify alternatives. When more than one 
alternative is available, the allowable keywords are shown 
Separated by slash marks, with the default value given 
first. Subcommands are terminated with carriage return. 
Tenex continues accepting sub-commands until the user types 
"BEGIN", or a carriage return with nothing before it, at 
which point the requested action begins. Subcommands are 
listed below by function. 


a) Additional data to print: The following sub-commands 
cause Tenex to. print additional information for each file 
selected (over and above the minimal name.,extension;version 
number). 


@@ACCOUNT% 
Tenex prints the name or number of the account’ that 
will receive storage charges for this file. (See 
Section IIT) 
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@@PROTECTIONS 
The protection status of the file. 


@@SIZEZ 
Tenex prints size of file in "pages". A Tenex page 
contains 512 PDP-19 words, 


@@LENGTH (IN BYTES)% 
Tenex prints size of file in "bytes", A byte is a 
portion of a fuil computer word; its length is measured 
in bits. The byte length for a given file will depend 
on the information stored. Text files, for example, 
contain 7 bit bytes. Tenex types the byte length 
applicable in parentheses after the length. 


@@DATES (OF) WRITE/READ/CREATIONS 
Tenex prints the date on which the file was most 
recently written or read, or its creation date, 
depending on the keyword selected. To obtain the most 
recent date for more than one of the _ possible 
operations, one can give repeated DATES commands, each 
time specifying a separate keyword. 


@@OTINES (AND DATES OF) WRITE/READ/CREATIONS 
Tenex prints the most recent time and date of the 
operation. As above, the command can be repeated to 
document more than one operation. 


BAVERBOSEZ : 
Tenex prints the standard file information (name, 
extension, version numbers, 3;T if temporary) plus 
account, protection, size in pages and dates of last 
write and read, This information just fits on one 
teletype line. 


G@GEVERYTHING% 
Tenex prints everything printable about each file. 
This includes the standard file information plus 
everything that can. be selected by the above 
Subcommands. 


b) Printing Format. In listing file information, Tenex 
normally single Spaces, columnizes the various fields of 
information, and provides a tabular heading if information 
is requested beyond account and protection. The following 
commands alter the normal format. 


GGNO (HEADING )% 
Suppresses heading, if any. 


@S8DQOUBLESPACES 
Output is double spaced. 
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@@SEPARATE (LINES FOR EACH VERSION)% 
Forces a separate listing for each version of a file. 
This will happen automatically if information printed 
by one of the subcommands differs by version. 


BECRAMZ 
Suppresses columnization. The separate items of 
information for each file follow one another regardless 
of length. This produces faster but less intelligible 
directory listings. 


c) Miscellaneous. 


@@DELETED (FILES ONLY)% 
Tenex prints data only for those files the user. has 
deleted, but which have not yet been eliminated by 
EXPUNGE or a system backup operation. (See DELETE, 
UNDELETE, EXPUNGE this section.) 


@@OUTPUT (TO FILE) file designator % 
The output of DIRECTORY can be sent to other’ Tenex 
files or outnut devices, as well as the user's 
terminal. The file designator can specify a new or 
existing file; its name and extension, if omitted, 
default to "DIR" and ".DIR" respectively. 


@@LPTS 
Short for "OUTPUT (TO FILE) LPT:". Sends the output of 
DIRECTORY to the line printer. 


oe 


d) Begin Listing. The following are equivalent; they 
terminate subcommand input and begin the listing. 

@@BEGING 

CO 


e) Examples. The following demonstrate some of the options 
Seay Tabie with DIRECTORY. 


@DIRECTORY, 
@OVERBOSES 
00% 


PGS WRITE READ 
ALPHA. ABC313P7777525;A123456 6 19-AUG-=70 21-AUG-70 


BETA. 3$13P775200;A56789 2 14-JUL-70 14-JUL-70 
eAV gc, leP7 752023000789 11 10-NOV-70 12-NOV-70 
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3. COPY 


To move information within Tenex:; 


@COPY multiple file designators (TO) file designator 
——— [MESSAGE]% 


The source file(s) must exist. Tenex takes the highest 
existing version of each file if none is specified. The 
destination designator can name an existing file, a new 
file, or a new version of an existing file. If the user 
selects an existing file but omits the version number, Tenex 
supplies a number one greater than the highest existing 
version (IV-A-5). COPY accepts subcommands (described 
below) when the destination file is terminated with comma. 


After termination of the second designator (space, altmode, 
comma, or carriage return) Tenex types one of the following 
messages: 


[NEW FILE] 

[NEW VERSION] 

fOLD VERSION] 

[OK] (for devices without file names) 


depending on the file selected by the second designator, and 
then awaits a final confirming carriage return. 


The effect of COPY depends entirely on the arguments given. 
@COPY DTA1:ALPHA.ABC (TO) DATA.DAT;1 [NEW FILE]2 


Information was transferred from Dectape 1 into a new. disk 
file. | 


@COPY DATA.DAT;1 (TO) LPT: [OK]% 
The file was listed on the line printer. 

@COPY DTAI:BETA.XYZ (TO) DtFATA.UtFAT31 [OLD VERSTON]% 
Another file was brought in from Dectape, replacing the 


contents of DATA.DAT;:1. +F was used for recognition of DATA 
and .DAT so that the version could be entered by nand. 


@COPY <SMITH>ALPHA.ABC;1 (TO) SALPHA.ABC;2 [NEW VERSION] 2 


A file in directory <SMITH> was duplicated in the user's 
(Jones) connected directory. Beginning the destination file 
with altmode will default its name and extension to tnose of 
the last source. file. Tenex picks a version one greater 
than the highest in the destination directory. 
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@COPY PTR: (TO) PTP: [0K]% 


A paper tape was duplicated. 


Multiple Source Files 


When multiple source files are designated, the information 
they contain is concatenated, in the order given, into the 
output file. If a list of files is entered, comma must 
terminate each file but the last. When * is used and 
version omitted, Tenex will pick the highest version of each 
file selected. 


@COPY B+FETA.* (TO) ALPHA.ABC;3 [NEW VERSTON]2 
BETA. 31 . 
BETA. XYZ32 

@ 


The contents of BETA.;1 and BETA.XYZ3;2 were concatenated to 
form a new file, ALPHA.ABC;3. 


@COPY AtFLPHA.+FABC31,D$ATA.DAT;1 (TO) LPT: [OK]% 
ALPHA.ABC31 

DATA.DAT31 
@ 


Tenex produced a combined listing of the two files. 


Byte Size and COPY Subcommands 


Tenex handles information in units called bytes whose size 
depends on the nature of the information and the information 
handling device. Generally tne user need not’ concern 
himself with the question of byte size, as COPY, and the 
other Tenex file commands will nearly always make correct 
assumptions. However, the following should be noted. 


Disk, magnetic tape, and Dectape files are physically broken 
up into 36 bit words, corresponding to the 36 bit word size 
of the PDP-10 computer, regardless of the kind of 
information they contain. 36 bit words are always 
transferred when copying between files stored on these 
devices. 


Depending on its type, the information stored on these 
devices may occupy bytes equal to or less than the 36 bit 
word length. For example, binary information occupies 36 
bit bytes, while ASCII characters occupy 7 bit bytes. When 
the byte size is less than 36 bits, bytes are packed left 
justified into 36 bit words with any unused bits on the 
right left vacant. For example, with ASCII information, 
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five characters are packed into each word with the right 
most bit vacant. With disk files a record is kept of byte 
size; with magnetic or Dectape files, there is no such 
record, 


Teletype terminals and the line printer deal with 7 bit 
ASCII characters. 7 bit bytes are always transferred when 
copying between these devices. When the transfer is between 
one of these devices and disk, magnetic tape, or Dectape, 
Tenex will pack or unpack 7 bit bytes into or out of 36 bit 
words, as appropriate. 


Because these devices are physically limited to one kind of 
information and one byte size, Tenex can always make correct 
assumptions about them when they appear in a file command. 
In general, the same is true of any other device restricted 
to a single byte size. 


Certain devices can handle several types of information each 
implying a different byte size, and a different treatment. 
For example, the physical eight hole unit of paper’ tape 
information can be interpreted as containing an 8 bit byte, 
a 7 bit ASCII byte, or one sixth of a 36 bit binary byte. 


With transfers to or from this kind of device, Tenex can 
sometimes make correct assumptions about the information 
involved. However, in other cases’ the Situation 1s 
ambiguous, and Tenex must be told what to do. 


To this end, COPY includes optional subcommands that specify 
the kind of information to be transferred. With 1/23/71 
Tenex, these subcommands serve two main purposes. 1) They 
Specify the information to be involved in a paper tape 
transfer, and 2) when COPYing from magnetic or ODectape to 
disk they can be used to establish the desired byte size 
record in the disk file. However, the intent of these 
Subcommands 1S general, and they will apply to. other 
multi-format devices that may be added to the system. 


To modify COPY with subcommands, terminate the destination 
file designator with comma. After the confirming carriage 
return, Tenex will type "@8" and await subcommand input. A 
null subcommand (just carriage return) will initiate the 
COPY operation. The subcommands are: y 


@GASCII2Z 
Specifies 7 bit ASCII bytes. In particular, 1) 
declares a source or destination paper tape to be in 
ASCII format, and 2) stores a 7 bit byte size record 
with a destination disk file. 


@@BINARYS 
Specifies 36 bit binary bytes. Declares a paper’ tape 
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to be in binary format; stores a 36 bit byte size 
record with a destination disk file. 


@@IMAGES 

Specifies 8 bit image bytes. Causes an exact image 
transfer to or from paper tape in 8 bit bytes, each 
representing one eight hole line of paper tape. Allows 
punching and reading paper tapes in non-standard 
formats. With disk, magnetic tape or Dectape files, 8 
bit bytes are packed four to a word with bits 31 to 35 
unused. Stores an 8 bit hyte size record with a 
destination disk file. 


@@IMAGE BINARY? 
Same as IMAGE, except with paper tape this command 
Suppresses the checksum processing normally done by 
Tenex. Not of interest to most users. 


Examples: 


@COPY PTR: (TO) DATA.DAT;2 [NEW VERSION] ,% 
@UBINARYS 


ee% 


@COPY PTR: (TO) BFETA.MAC;1, [NEW FILE]% 
@BASCITZ _ 
00% 


COPY will always try to do something no matter what 
combination of files, devices, and subcommands is specified. 
However, the following conditions may arise. Certain 
subcommands will not work with certain file designators. 
For example, one cannot declare binary information in a COPY 
to the line printer. When this happens, Tenex ignores the 
subcommand and types the message: 


[ILLEGAL MODE SUBCOMMAND BEING IGNORED] 


In the absence of a subcommand, Tenex makes an assumption 
about byte size based on the devices involved, the byte size 
record on a disk file, and/or the extension of a named file. 
Usually, the assumption is unambiguous; however, with paper 
tape it may not be, and in this event Tenex types: 


[YOU DIDN'T SPECIFY A PAPER TAPE FORMAT 
WITH A SUBCOMMAND 
SO ASCII/BINARY/IMAGE IS BEING ASSUMED] 


Disk File Complications 


Certain disk files (notably Save Core files - Section VII) 
may contain information taken from disjoint pages of core 
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memory. As long as these files remain on the disk, their 
structure, 1.e., the correspondence between file and memory 
pages is retained. However, when copied to any other 
device, or when concatenated on the disk through the use of 
multiple file designators, the information in these files is 
compacted, and the original structure, or “holes", are lost. 


Files created with the SSAVE command (VII-A-2) have the 
additional complication of an “end of file pointer" beyond 
which additional pages may exist: When these files are 
concatenated or copied to devices other than disk not only 
the holes, but also the extra pages are lost. 


Should Tenex encounter one of these situations in executing 
a COPY, it will type one or both of the following messages: 


[HOLES IN FILE WILL BE LOST] 
[PAGES AFTER EOF WILL NOT BE COPIED] 


Use of 42 

When copying from the user's controlling teletype (TTY:) to 
some other file, all text following termination of the COPY 
command is taken as input data to be transferred. The 
(CTRL)-Z (+Z) character serves as a terminator for the input 
text; typing +Z completes execution of COPY and returns 
control to Tenex. 


Errors: 3 file designator errors 
2) device CAN'T DO INPUT 
3) device CAN'T DO OUTPUT 
4) device CAN'T DO NORMAL MODE INPUT 
5) device CAN'T DO NORMAL MODE OUTPUT 


Errors 2 and 3 occur on misuse Of an input only or output 
only device, for example an attempted COPY to PTR: or from 
LPT:. Errors 4 and 5 occur with special devices that can't 
be accessed through the file system in the normal manner. 
In 1/23/71 Tenex, magnetic tape units are in this category. 


4. APPEND 
This command adds the information in one or more source 
files to the end of a destination file. The source files 


are unaffected. 


@APPEND multiple file designators (TO) existing 
disk file designator &% 


Examples; 
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@APPEND D+FATA.D+FAT;1 (TO) D+FATA. D+FAT 32 
[OLD VERSION] 


would add the contents of DATA.DAT:1 onto the end of 
DATA.DAT;2, leaving DATA.DAT31 unchanged. 


@APPEND B+FETA.* TO ASFLPHA.*FABC.2 [OLD VERSION]% 
BETA.MAC31 

BETA. XYZ32 

@ 


The contents of the BETA files were concatenated and 
appended onto ALPHA.ABC;2. 


@APPEND PTR: TO DATA.DAT;2 [OLD VERSION] ,% 
@QBINARYS 
00% 


Information from a paper tape was appended to DATA.UVAT;2. 
The paper tape was declared to be in binary format. Tenex 
selected the hianest existing version of the destination 
file. | 


The format and rules for COPY generally apply to APPEND, 
including the use of multiple file designators, byte size 
conventions, subcommands, the use of +Z, and warning 
messages. 


Save Core Files can never be appended, even when a_ single 
source and destination are both on disk. Appending such 
files will always destroy their structure and lose. their 
extra pages. 


Errors: all COPY errors. Also: 
DESTINATION FILE NOT ON DISK 
FILE name CANNOT BE APPENDED TO 
(file access protection violation) 


5. RENAME 
To change a file name: 


@RENAME (EXISTING FILE) existing file desiqnator 
(TO BE) file designator % 


Both file designators must refer to the same device, and the 
device must Carry named _ files. If the second file 
designator specifies an existing file, the file's contents 
are expunged, and its name given over to the first file. 
After the second file designator Tenex types one of the 
messages (such as [NEW FILE]), listed under COPY, and then 
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awaits final confirmation. Exanple: 


@RENAME (EXISTING FILE) DATA.DAT;2 (TO BE) SAVE.DAT:1 
{NEW FILE]% pa 


Errors: file designator errors 
FILES NOT ON SAME DEVICE 
6, ACCOUNT 


To change the account that will receive storage changes _ for 
a disk file: 


@ACCOUNT (OF FILE) existing disk file designator 
(IS) account % 


The Account file descriptor is covered in IV-C-3. Depending 
on his status (III-=A-3) the user must enter a five or six 
digit number or an alphanumeric account name. Example: 


@ACCOUNT (OF FILE) SAVE.DAT;1 (IS) 12345% 
Errors: file desianator errors 
DISK FILES ONLY 
"2" If account must be numeric but isn't 
7. PROTECTION (not implemented in 1/23/71 Tenex) 


To change the protection descriptor for a file: 


@PROTECTION (OF FILE) existing disk file designator 
(IS) protection % 


"Protection" is a 6-digit octal number as described in 
IV-D-2. Example: 


@PROTECTION (OF FILE) BETA.;1 (IS) 770000% 

This would restrict file access to the user. 
Errors: file designator errors 

DISK FILES ONLY 

"2" TF PROTECTION NOT OCTAL NUMBER 
Although PROTECTION is not yet implemented, the same effect 
can be achieved with RENAME. For example, the following is 
equivalent to the example above: 


@RENAME BETA.3;1 (TO BE) BETA.313;P770000% 
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8, DELETE 
To eliminate one or more files: 
@DELETE multinle file designators % 


If on a device other than disk, the files are eliminated. 
If on disk, they are marked as deleted and _ become 
inaccessible to Tenex commands except UNDELETE, EXPUNGE 
(below) and DIRECTORY. After deletion disk files remain on 
the disk and can be UNDELETEd until EXPUNGEd or until the 
next routine disk backup operation. (See system operators 
for disk backup schedule.) If a file designator is entered 
without version number, Tenex will delete the lowest 
non-deleted version. Examples: 


@DELETE SAVE.DAT;1% 


@DELETE BFETA.*;* 
BETA.3;1 | 
BETA. MAC31 
BETA. XYZ31 
BETA. XYZ32 
@ 


If a file desiaqnator list is specified, the individual 
designators can be senarated with comma or Space, and 
altmode can be used anywhere in the list. Since name and 
extension default to those of the previous entry, they can 
be omitted when several versions of the same file are to. be 
deleted: 


@DELETE DTAL:BSETA.XYZ_,A$LPHA.ABC31 ,33% 
DTAL: BETA. XYZ 

ALPHA.ABC31 

ALPHA. ABC;3 
@ 


Errors: file designator errors 
PROTECTION VIOLATION 

9, UNDELETE 
To revive DELETEd disk files: 

@UNDELETE multiple deleted file designators % 
The file(s) are restored to normal status; they are once 
again accessible to executive commands. Multiple file 
designators can be specified with the format options of 


DELETE available for entering file designator lists. In the 
case of multiple files, any non-celeted files are ignored, 
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@nd their designators are noc printed. Examples: 
@UNDELETE SAVE.DAT;1% 
@UNDELETE AtFLPHA.*;*2% 
ALPHA.ABC;1 


~ALPHA.ABC;3 
@ 


Errors: file designator errors 
NOT DELETED 


10. EXPUNGE 


To remove permanently any DELETED files in the connected 
disk directory: 


@EXPUNGE (DELETED FILES)% 


Errors: none = no complaint if no DELETEd files exist. 


11. CLEAR 


To remove all files on a magnetic tape or Dectape: 


@CLEAR (DIRECTORY OF DEVICE) device name 
TCONFIRM] % 


Currently this command is legal only for Dectapes. pecause 
of its possibly disastrous consequences, this command always 
requires a confirming carriage return on the next line. 
Example: 


@CLEAR (DIRECTORY OF DEVICE) DTA3: 
[CONFIRM] % = 


Errors: "2" Gf no such device (type 2) 
DECTAPES ONLY 
device: NOT AVAILABLE 
device: ASSIGHWED TO JOB n 
device: NOT MOUNTED 


12. SHUT 


As discussed in IV-D-2, Tenex files must be opened prior’ to 
manipulation by user programs or other mechanisms within 
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Tenex. To close all files opened by a subsystem or _ user 
program: 


@SHUT (ALL OPEN FILES)% 


Errors: none. No complaint if no files open. 


13, JFNCLOSE 


When opened, a Tenex file is assigned a Job File Wumber 
(JFN) (IV-D-2). To close a specific opening of a file: 


@JFNCLOSE jfn % 


A list of currently assigned JFNi's may be obtained with the 
FILSTAT command (VIII-9). Example: 


@JFNCLOSE 3% 
Errors: "2" for no such JFN assianed. 


Note: SHUT and JFNCLOSE generally need only be applied in 
unusual cases, such as program debugging. Files opened by 
Tenex commands such as COPY or APPEND are génerally closed 
as part of command execution. Files opened by sulisystems or 
user programs are generally closed by the subtsvstem or 
program in question. Any such files are also closed by the 
Tenex commands GET, RUN, START or RESET, (VII). JFNCLOSE is 
more powerful than SHUT in that it will close files left 
open by (rare) Tenex command failures, as well as files 
Opened by subsystems or user programs. 


14, CONNECT 


As explained in IV-A-2, when a user logs in to Tenex, the 
system initially sets up access to his’ primary disk 
directory. Subsequent to logging in, when the user. omits 
directory name from an executive command, Tenex takes his 
primary directory name as default value. To shift access to 
a different disk directory, either one's own or someone 
else's: 


@CONNECT (TO DIRECTORY) directory name 
(PASSWORD) password % 


Subsequent to this command, Tenex will take _ the new 
directory name as default value when it is omitted from 
executive commands. As well as directory name, the user 
must specify the password associated with the new directory. 
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@CONNECT (TO DIRECTORY) SMITH (PASSWORD) & 
@DYRECTORY | 
ABC.F0031 

@ 


It is always possible, of course, to access any file or 
directory to which one has been granted access privilege, by 


Supplying its name directly in executive commands: 


BCONNECT (TO DIRECTORY) JONES (PASSWORD) % 
@DIYRECTORY <SMITH>% 

ABC. FO031 

@ 


Errors: "2" for no such directory (type 2) 
INCORRECT PASSWORD 


Io6 Llod 


To print out the contents of symbolic files on the line 
printer at the computer center, 


@LIST (FILE) multiple file designators % 
Examples: 

@LIST (FILE) FOO.MAC;1% 

@LIST (FILE) ALPHA. ABC,BETA. XYZ31% 

@LIST (FILE) PTR:% 


The second example shows how more that one file can be 
listed with one command; the third would list a paper tape. 


If the line printer is in use by another job, Tenex types 
"{LPT: BUSY-"; then, when the line printer becomes 
available, Tenex types "GO)". Example: 


@LIST (FILE) ALPHA.ABC31% 
{TLPT: BUSY-G0] 
@Q 


Of course, the wait may be interrupted and the LIST command 
terminated by typing +C., 


Each page of the listing is normally headed with the file 
name, a date and time, and the page number. The date and 
time when last written is used for disc files; the date and 
time of listing is used for other files. 
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A new page is Started whenever a form feed character 
((CTRL)-L) is encountered in the file. If the file contains 
more lines between two form feeds than will fit one page of 
printout, Tenex will divide that page, at what it considers 
reasonable places, into aS many pages as _ necessary. The 
additional pages created by these divisions be numbered 
"nel", "n:2", etc. For example, a file containing no_- form 
A at all will be printed with pages numbered 1, 1:1, 
1:2, etc. 


Any control characters encountered in the file, including 
form feeds (+L's) are printed as "+" followed by a letter. 


If a comma is typed between the last file name and the final 
carriage return in a LIST command, subcommands will be 
accepted. As with other commands accepting subcommands, 
subcommand input is terminated and execution initiated by 
typing just a carriage return, The subcommands are: 


@@PAGES n,n nen... % 
ows listing only selected pages or groups of pages 
from file. 
Example: @@PAGES 1,5,21-27,32-33,58% 


@@HEADING any text & 

Allows specifying any heading you wisn to be used at 
the top of each page of Jlisting. The text may be 
terminated with carriage return or altmode; multiline 
headings may be given by using the continuation 
character "&", No heading at all may be specified by 
typing just HEADING (carriage return). If HEADING is 
given, the page numbers are still printed unless the 
following subcommand is also given. 


@@NO (PAGE NUMBERS)% 
Suppresses printing of page numbers. If heading 1s 
also suppressed, this makes tnree more lines available 
for printout. 


@OSPACING n % 
SPACING 2 Causes listing to be double-spaced, SPACING 3 


causes it to be triple-spaced, etc. 


G@QWIDTH n % 
Specifies maximum number of columns to use. When a 
line longer than the width is encountered, its 
continuation on the next line is prefixed with "**", 
Default width is 80 except 72 when output is to a 
terminal. Thus when you wish to make a listing on wide 
line printer paper, you must give WIDTH 13c. 


@@LENGTH n &% 
Gives maximum number of lines per page. Default is 60. 


IV. TENEX FILE SYSTEM Page 60 


@@QUTPUT (TO FILE) file designator % 
Sends output to specified device, terminal, disc file, 
etc, instead of to the line printer. 


Errors: file designator errors (see IV-E) 
LPT: NOT MOUNTED (off line) 


16. TYPE 
To print symbolic files on your terminal: 
@TYPE (FILE) multiple ‘file designators % 


Identical to LIST (just described) except for the use of the 
terminal in place of the line printer. 


If you wish printout to be properly positioned on terminal 
paper which has perforations between paqes, initialize the 
paper position before TYPEing by typing a form feed (CTRL-L) 
then setting the paper manually to the top of a page. Then 
enter your TYPE command, using a form feed in place of the 
final carriage return. 


At the end of each page, paper is fed to the top of the next 
page with a form feed character. Tenex normally simulates a 
form feed by typing the appropriate number of Carriage 
returns, but users with suitably equipped sprocket-feed 
terminals may obtain listings faster by giving the FORMFEED 
command (see IX-2) prior to TYPE. : 


Some users with friction-feed terminals will find that their 
terminal does not feed paper accurately, so that the listing 
"drifts" upward or downward on the page. Such users will 
find this additional subcommand useful: 


@@PAUSE (BETWEEN PAGES)% | 
Causes Tenex to ring the terminal bell and wait for you 
to type a carriage return at the top of each page, 
giving you a chance to readjust the paper position 
manually when necessary. | 


Errors: see LIST 


G. FUTURE ADDITIONS 


Subsequent versions of Tenex will have several new File 
Commands. One command, DEFINE, will allow users to create 
Synonyms for a file name, without having to RENAME the 
Original file. 
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V. DEVICE HANDLING 


A. DEVICE aia 


Most input/output devices: atvow: access by one ‘one user at a 
time. To provide:s orderly: ‘access, the commands in this 
section allow: ‘the: ¢ ius er: to: reserve a device prior to 
accessing it, and ito ‘release. a: reserved: device when it 1s no 
longer:; needed. : Thesé@:° cotimands.: apply in © particular to 
magnetic tape and Dectape® uni'ts.: and the paper. tape punch and 
reader, which must generally be reserved before and released 
after use through the ASSIGN and DEASSIGH oe ae. Pol Ons 


With other devices’ the Situation varies. pee ee 
teletype liness3;avesassighed incorderly: fashion: to: entering 
users by the system operators or tne dial up equipment. 
However, a user job can accesS°additional teletypes beyond 
the controlling terminal for input/output purposes, and when 
used this way, teletyne lines should be ASSIGNeds* and 
DEASSIGNed. Although the line printer can take only one 
user at a time, it need not be reserved in advante, since 
Tenex handles the queuing of line printer’: Outputi'requests 
internally. | ; 

As well as the neea for reseHaitiens, ‘Déctapes sand magnetic 
tapes carry file divwéctdriés ‘that musit be communicated to 
Tenex before their files can be read or written. When a 
tape unit is ASSIGNed Tenex reads the directory from the 
tape (if any) it carries as part of the assignment:'process. 


Two ‘add? tional commanascabbow sfurtherssoperations « tapes 
and tape directdrtes.: : MOUNE<wihl ofelad sthre © directory: ‘from a 
tape unit and enable access to its files. This is useful 


when no tape was loaded at the tine the unit was ASSIGiied or 
when a subsequent tapve is to be accessed on the same _ unit. 
Since MOUNTing an unassigned unit does not block accesis'*from 
other jobs, MOUNT can also be used instead of ASSTGH = when 
two or more jobs need simultaneous access to thé'same tape 
unit. UNMOUNT will block computer access to a tape unit 
while a new tape isl being lowded.: ‘This ‘prevents inadvertent 
access to the unit tuhn:tedi the! mew! SAO aa na's been properly 
transmitted to Tenex. SOR De 1 


é 
J § 
eg 275% ee : BIE HS 
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1. ASSIGN 


ee 
To reserve a device and read its nes ase d (if any ) : 


é 
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@ASSIGN device names 
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Examples: 


@ASSIGN PTR:% 
@ASSIGN DTA7:% 


Errors: "2" if no such device (type 2) 
device: CANNOT BE ASSIGNED 
device: NOT AVAILABLE (not assigned, 
but in use by another job) 
device: ALREADY ASSIGHED TO JOB n 
YOU CAN'T ASSIGN YOUR CONTROLLING TERMINAL 
SYNONYMS NOT IMPLEMENTED YET 


2. DEASSIGN 
To release a previously ASSIGNed I/0 device: 
@DEASSIGN device name% 


Examples: 


@DEASSIGN PTR:% 
@DEASSIGN DITA7:% 


Errors: "2" if no such device (type 2) 
device: NOT ASSIGNED 
device: NOT ASSIGNED TO YOU 

3. MOUNT 


To cause Tenex to read the directory from a magnetic 
Dectape unit, and enable access to its files: 


@MOUNT device name % 

Examples: 

@MOUNT DTA7:% 

Errors: "2" if no such device (type 2) 
device: NOT A MOUNTABLE DEVICE 
device: NOT AVAILABLE 
DEVICE: ASSIGNED TO JOB n 

4. UNMOUNT 


To block access to a tape unit: 


@UNMOUNT device name % 
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or 
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Example: 
WUNMOUNT DTA7:% 


Errors: "2?" Gf no such device (type 2) 
device; NOT A MOUNTABLE DEVICE 
device: NOT AVAILABLE 
DEVICE: ASSIGNED TO JOB n 
device: NOT MOUNTED 


B. FUTURE ADDITIONS 


Future Tenex will permit one to refer to I/0 devices by 


"logical names" in user programs, equating an appropriate 
physical device to each such name prior to running the 
program. For exannle, the logical name "SOURCE" might be 


equated with DTAl: on one occasion, DTA7: on another, = and 
PTR: on ae third. This “synonym feature" will permit a 
program to access different devices on different occasions 
without needing to be rewritten. It will avoid the problems 
that otherwise occur when the expected I/0 device is 
assigneu to another job when the program is to be run. When 

the synonym feature is implemented, ASSTGi will take on the 


form: 
BASSIGi#! device name (AS) [logical name] % 


where logical name is an ontional arqument. An attempt to 
use this form at present will trigger the error message: 
"SYNOHYMNS WOT IMPLEMENTED YET". 
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VI. SUBSYSTEM CONTROL 


Tenex contains a number of subsystems, each stored in the 
System as a disk file, and designated in the usual way by 
file name,extension; version number. The collection of 
Subsystem file designators is treated as a special group of 
Tenex commands. To activate a subsystem, type its file 
designator instead of an ordinary Tenex command, at any 
point where Tenex is awaiting command input. Terminate with 
carriage return. Tenex will perform recognition’ on 
Subsystem designators as explained in IV-B, selecting the 
highest version number if more than one version exists. 


Example: 
@TELCOMP.SAV3;12% 


would activate the TELCOMP subsystem. Control will now pass 
from the executive to the Subsystem, and _ further 
communication will take place in the language of the 
particular subsystem activated. Also, the way to deactivate 
the subsystem and return control to the executive will 
depend on the conventions of the particular subsystem. 
However, control can always be returned to the executive by 
typing one or more controt-C's (+C). 


The table below lists the major subsystems and their 
functions. In addition there are a number of other 
subsystems serving less common purposes. All subsystems are 
filed together in one directory with the name <SUBSYS>. At 
any time one can obtain a complete list of all subsystems 
by: 


@DIRECTORY <SUBSYS>% 


Note, however, that the directory name <SUBSYS> need not be 
given when activating subsystems as above. 


Full documentation on the properties and operation of the 
subsystems 1S contained in the separate subsystem manuals. 
In the table that follows, version numbers’ have been 
omitted, since these change from time to time as the 
subsystems are updated. 
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NAME DESCRIPTION 


1. Conversational computation languages 
TELCOMP. SAV BBN Telcomp III Language 


2. Symbol manipulation languages 
LISP.SAV BBN LISP language 


3. Text editing languages 


TECO.SAV Character-oriented text editor 
RUNOFF. SAV Output formatted text 
SOUP .SAV Automatic updating of text files 


4. Assemblers and compilers 


F40.SAV Fortran IV compiler 
MACRO.SAV Standard DEC assembler 
FAIL.SAV More advanced assembler 
BLISS.SAV Carnegie system implementation language 
compiler 
- SAIL.SAV Stanford extended ALGOL compiler 
BASIC.SAV BASIC algebraic language compiler 


5. Loaders 


LOADER.SAV Linking loader for output of 
PDP-10 assemblers and compilers 
LDR.SAV Loader adapted to load 10/50 


compatible programs 


6. Library maintainance programs 


FUDGE2.SAV Build and update library 
program files 


Fe Debugging programs 


DDT.SAV An “invisible” DDT, not implemented yet 
UDDT.SAV Interim debugger for PDP-10 
machine language programs, similar to 
DEC DDT-10. Invoked by the DDT 
“command, VII-A-14., 
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8. Cross-reference and comparison programs 


CREF.SAV Cross-reference agenerator-assembly 
program symbols 

SRCCOM.SAV Compare and list symbolic files 

BINCOM.SAV Compare binary files 

TYPREL.SAV Analyze contents of relocatable 


binary files 


9. Conversion programs 


CONVERT. SAV Convert SDS-940 formatted tapes 
to and from Tenex files 


FIOCNV.SAV Convert PDP-10 symbolic files 

to paper tapes in Friden or Dura code 
RELRIM.SAV Convert relocatable binary 

files to RIM mode paper tapes 
FLIST.SAV Does column 1 format conversion 


for FORTRAN output 


10. Applications programs 


ECAP.SAV Electronic cicuit analysis program 
FLOW. SAV Flow charts FORTRAN source programs 


11. Miscellaneous 


PALX.SAV Assembler for the PDP-8 
computer 

TTYTST.SAV Teletype tester 

CERTIFY.SAV Magnetic tape certifier 

CHESS.SAV Chess playing program 

DOCTOR. SAV Simulated psychiatrist 


WATCH. SAV System statistics 
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VII. PROGRAM CONTROL AND DEBUGGING 


Tenex contains a special class of files and a number of 
commands that assist in saving, manipulating, and debugging 
programs. Tenex Save Core (extension.SAV) files contain 
information taken from core memory. Their main intent is to 
preserve completed binary programs. A Save Core _ file 
contains an image of those portions of memory selected by 
the user through the SAVE or SSAVE commands described below. 


The program in a Save Core file will usually contain a main, 
initializing start up location. It may also contain a 
re-entry location that serves as a convenient place for 
restarting the program after an interruption (for example by 
tC). By convention, these locations are generally placed in 
contiguous addresses to form what is known as the program's 
"entry vector", 


The address and length of the entry vector can be declared 
as part of the loading process when programs are set up 
through the loader subsystem, or by the ENTRY VECTOR command 
described in this section. When a Save Core file is 
created, the location and length of the entry vector is 
Stored in the file along with the program. When the file is 
reloaded into core this information is communicated to Tenex 
for use by the RUN, START and REENTER commands described 
below. 


save Core files are created by SAVE and _  SSAVE., The data 
they contain can be loaded back into the memory locations it 
came from through GET, MERGE, or RUN. GET and MERGE will 
load the file without starting it; RUN will start execution 
at the starting address stored with tne file. In addition, 
a Save Core file, once placed back in core, can be started 
by START (at the starting location), REENTER (at the reentry 
point) or GOTO (at an arbitrary location specified by the 
user). These commands, together with a number of other 
Tenex program control and and debugging commands, are 
described below. 


A. PROGRAM CONTROL AND DEBUGGING COMMANDS 


ie “SAVE 


To create a SAVE CORE file: 


@GSAVE (CORE FROM) n (TO) Orn (FROM) n (TO) Ns. = , 
(FROM) n (TO) n (ON) file designator [message]% 
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In the above, "n" stands for an octal core address (from 20 
through 777777). Each pair of addresses denotes a range of 
core locations to be saved. The first member of each pair 
is terminated with altmode or space. With altmode, Tenex 
will echo the "(TO)", otherwise not. The second address of 
a pair can be terminated by space, altmode or comma. Comma 
indicates another pair to follow. After the comma the user 
can enter another address immediately, or type altmode, in 
which case Tenex will type (FROM) before awaiting the next 
address. Space or aitmode instead of comma (causing nothing 
or "(ON)" to be echoed, respectively) denote the end of the 
address list and indicate that a file designator is to 
follow. Any legitimate file designator is legal. If the 
user terminates file name with altmode, Tenex will default 
the extension to SAV;. Following the file designator, Tenex 
will type one of the standard file messages listed under 
COPY (IV-F-3). For example: 


@SAVE (CORE FROM) 123 (TO) 777,$ (FROM) 10000 (TO) & 
17/777 (ON) DTA1:PROG1.SAV;1 [NEW FILE]2 


would create a new Dectape file, "PROG1.SAV;1" containing 
the contents of core locations 123(8) through 777(8) and 
10000(8) through 17777(8), plus the location and length of 
the entry vector, if any. Note the use of the & character 
to continue the command on the next line. (See II-B-8) 


Had the user substituted space for the altmode terminator 
used by convention in this manual, and omitted altmode after 
the comma, the command would look like: 


@SAV 123 777, 10000 17777 DTA1:PROG1.SAV3;1 [NEW FILE)% 


The user can save all, or the bottom or top portion of core 
by defaulting either or both members of the first address 
pair with altmode. In this case, Tenex will select (and 
type back) 20 for the first address, 777777 for the second, 
Specifying addresses for which no core is assigned does not 
produce an error; any assigned core is saved and the rest of 
the request is ignored. 


For example, 


@SAVE (CORE FROM)$20 (TO) $777777 (ON) & 
DTA1:LONGDUMP.SAV;1 [NEW FILE]% 


would save all currently assigned core while 
@SAVE (CORE FROM) $20 (TO) 10000 (ON) PTP:% 


would save any core below 10000 on paper tape. 
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Other examples of save core commands follow: 


@SAVE (CORE FROM) 1000 (TO) 7777 (ON) & 
ALPHA.SAV31 [NEW FILE]% 


@SAVE (CORE FROM) 20 (TO) 21 (ON) & 
BtFETA.XYZ;3 [NEW VERSIONT% 


Errors: NO PROGRAM | 
"2?" for upper limit less than lower 
"2" for number greater than 777777 
file designator errors (see IV-E) 


2. SSAVE 


Tenex contains a mechanism that allows pages of core memory 
to be shared by concurrently running jobs. This mecnanism 
is aimed chiefly at subsystems that may be in simultaneous 
use by more than one Tenex user. Shared pages allow 
efficient use of core memory, reduce system overhead due to 
page swappina, and speed up the process of loading files 
into core. For a complete discussion of page sharing in 
Tenex, see the Tenex Tecnnical Manual. 


The SSAVE command allows the user to create files containing 
Sharable memory pages. When loaded into core, each page 
will be sharea by any jobs attempting to access the file’ in 
question, 


In order for sharing to work, the shared pages must contain 
“pure code", that is, no storage locations within them 
Should be changed during execution. In tnis case sharing 
will proceed in normal fashion. Should a page fail to 
contain pure code, then a private copy will be made for each 
job that changes its contents. This exploits the sharing 
mechanism as much as possible, but allows for the case where 
Sharing conventions are not adhered to. 


SSAVE differs from SAVE in that it creates sharable memory 
pages; it also differs in that the memory to be saved is 
Specified in octal page numbers from 0 to 777, j$instead of 
core addresses. The format of SSAVE is: 


@SSAVE (PAGES FROM) n (TO) n, (FROM) n (TO) ny... 
(FROM) n (TO) n (ON) file designator [Message]% 


In general, the format rules for SSAVE are identical to 
those of SAVE. The first pair of pages can be defaulted (by 
altmode) to 0 and 777 respectively. 


VII. PROGRAM CONTROL AND DEBUGGING Page 70 


For example, 


@SSAVE (PAGES FROM) 3 (TO) 7, (FROM) 400 (TO) 477 (ON) & 
SHRFIL.SAV31 [NEW FILE]% ca ~~ ~ 


Sharable Save Core Files can exist only on disk. Specifying 
a device other than disk with SSAVE or attempting to COPY a 
file created with SSAVE to another device will yield an 
unusable file. 


Errors: see SAVE except: 
"2?" for number greater than 777 


3. ENTRY VECTOR 


To establish an entry vector for a program currently in 
core, or to change the present entry vector: 


@ENTRY (VECTOR LOCATION) octal address (LENGTH) 
[octal number] % 


The address specifies where the entry vector is located in 
core; the length specifies its length in memory words. 
Lengths of 0, 1, and 2 are normal.* 


Length 0 specifies that no entry vector exists. Length 1 
specifies a one word entry vector which is the program's 
Start location; length 2 specifies a two word vector 
consisting of the program's start and re-entry locations in 
that order. If the length field is defaulted, Tenex will 
assume and type a length of l. 


Examples: 
@ENTRY (VECTOR LOCATION) 1776 (LENGTH) 2% 

A two word entry vector was declared at location 1775. 
GENTRY (VECTOR LOCATION) 400 (LENGTH) $1% 

A one word entry vector at 400. 


Errors: NO PROGRAM 
"?" for length greater than 777 


*To specify entry vectors compatible with the DEC 10/50 time 
Sharing system, length should be set to 254000, 


ee eee tances Sele at 


VII. PROGRAM CONTROL AND DEBUGGING Page 71 


4, GET 
To load a Save Core file back into core memory: 
@GET file designator % 


GET first clears the user's job by doing a RESET (see 
below). Next, it determines what core memory will be 
required by the contents of the Save Core file, assigns the 
memory, and reloads the Save Core information back into the 
addresses it came from. The location and length of the 
entry vector, if any, is also read from the file and placed 
in system storage. 


Any legal file designator can be specified with GET, but if 
the file got is not in fact a Save Core file, unpredictable 
results will occur. GET can be used with files created with 
either SAVE or SSAVE. Witn GET Tenex- will default to a .SAV 
extension, if one exists. Otherwise the recognition.§ and 
default rules of IV-B-3 apply. Version numter will default 
to the highest existing number. 


Examples: 
@GET PTR:% 
@GET ALPHA.SAV3;1% 
@GET BETA. 31% 


In the last example, no .SAV file existed, but Tenex found a 
null extension. 


Errors: file designator errors 


BAD CORE SAVE FILE FORMAT 
SYSTEM SPECIAL PAGES TABLE FULL 


9. MERGE 


To load a Save Core file back into memory, merging it with 
any information already there: 


@MERGE file designator % 


MERGE is similar to GET except 1) that Tenex does not RESET 
before loading the incicatea file, and 2) if an entry vector 
was already present, the new one is not Joaded. This means 
that currently assigned memory is generally left intact 
prior to the MERGE operation. If the contents of the Save 
Core file occupy memory pages disjoint from those already 
assigned, then new core is assigned and the result is a 
simple merger of the file with what is already in core. If 
the file information occupies pages overlapping those 
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Currently assigned, then the overlapped pages will be 
zeroed, and then replaced with pages from the file. If no 
memory was assigned at the time of the MERGE, then, as with 
GET, new memory is simply assigned as needed. 


Provided an entry vector was present prior to the MERGE, its 


addresses will continue to govern if the user does a START 
or REENTER (see below). 


As with GET, any file designator is legal, but only Save 
Core files meaningful. Also, with MERGE, Tenex handles file 
extension recognition in the same Way as with GET. 


Examples: 


@GET ALPHA. SAV3;1% 

@MERGE BETA. XYZ; 3% 
Referring back to the SAVE examples, the got file would 
occupy 1000(8) to 7777(8) and the merged file 20 and 21(8). 
The start and reenter addresses from ALPHA would continue to 
govern after the MERGE, 


@GET BETA. XYZ;3% 
@MERGE ALPHA.SAV;12 


This would put the same information in memory, but now’ the 
entry vector from BETA would govern. 


@GET DTA1:LONGDUMP.SAV3;12 
@MERGE ALPHA. SAV 31% 


Here the contents of ALPHA would overwrite the 1000(8) 
-7777(8) portion of LONGDUMP. 


@GET BETA. XYZ;3% 
@MERGE DTAT:LONGDUMP.SAV 312% 


Here, LONGDUMP (20 - 777777(8)) might wipe out the contents 
of BETA, but the start and reenter addresses from BETA will 
continue to apply. 


Errors: see GET 


6. RUN 
To load and start a Save Core file: 


@RUN file designator % 
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Run does everything GET does, and behaves in exactly the 
Same way with respect to file designators and _ “file 
extensions. Having got the indicated file and set it up’ in 
core, RUN then starts it at the starting address. 


Examples: 
G@RUN PTR:% 
@RUN ALPHA.SAV3;1% 


Errors: see GET, also: 
NO START ADDRESS 


The following three commands, START, REENTER, and GOTO, a1] 
assume that a program has been placed in core, either 
through the Loader subsystem or through GET, MERGE, or RUN. 
The program may have been freshly loaded, have run to 
completion, or had its running interrupted by +C or a 
monitor trap. Of these three commands, START and REENTER 
Cause execution to begin at the starting anc reentry 
addresses, respectively, while GOTO allows the user to 
select an arbitrary starting location. 


A fourth command, CONTINUE, provides a means for’ restarting 
a program after an interruption by +C. In this case, Tenex 
remembers where execution left off at the time of the +C, 
and execution begins again at this point. 


7. START 


To begin proqram execution at the starting location in _ the 
entry vector: 


@STARTS 


Prior to beginning execution, START closes all currently 
open files. 


Errors: NO PROGRAM 
NO START ADDRESS 


8. REENTER 


To begin program execution at the reentry address: 
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@REENTERS 


The idea behind reenter is to provide a graceful means’ for 
restarting programs without having to repeat a possibly 
lengthy initialization sequence. This initialization may 
have taken place in an earlier session or before an 
interruption during the current session. 


Errors: NO PROGRAM 
NO REENTER ADDRESS 


9, GOTO 
To begin program execution at an arbitrary location: 
@GOTO octal addressé 


The address must lie between 0 and 777777(8). Core memory 
must be assigned at this location and the address should, 
obviously, be a meaningful starting location for the 
program. 


Examples: 


@GOTO 123% 
@GOTO 1000% 


Errors: NO PROGRAM 
NO SUCH PAGE 
CAN'T EXECUTE THAT PAGE 


10. CONTINUE 
To continue execution of a program interrupted by +C: 
@CONTINUES 


When the user interrupts a program by tC, TENEX saves all 
volatile information, such as the contents of the program 
counter, accumulators, and other active registers. CONTINUE 
causes this information to be restored and execution to 
start again. The net effect is as though the interruption 
had never taken place. 


Errors: NO PROGRAM 
PROGRAM HASN'T BEEN RUN 
NOT INTERRUPTED 
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11. RESET 


To clear the job to which the user's teletype is currently 
attached: 


@RESET% 


RESET 1) releases any currently assigned core memory, 2) 
releases any subsystem currently in use, 3) closes any files 
that may be open. Other than assigned input/output devices 
(Section V) (which can only be released through DEASSIGN or 
LOGOUT), the effect is as though the user had just logged in 
and been assigned a fresh job. 


RESET is most useful when, through program malfunction or 
other circumstances, the user becomes confused over what 
System resources are currently assigned to him. RESET 
allows the user to start afresh with a guaranteed clean 
Slate without going through the LOGOUT-LOGIN sequence. 


Errors: None. One can always RESET 


The following two commands provide a minimum debugging 
facility for machine language programs. Each assumes that a 
program has been placed in core throtigh the Loader or GET, 
MERGE, or RUN, The program can be freshly loaded or may 
have been run and interrupted. 


12. Examine Location 
To examine the contents of a core memory location: 
Goctal address/ 


TENEX will type the contents of the word selected as a_ pair 
of unsigned octal integers in the format left half,,rignt 
half. Unlike other Tenex commands, this one Jacks” an 
initial keyword. Also, it requires no confirmation; Tenex 
types the requested information immediately upon’ receiving 
the "/" character. 


Examples: 


@123/ 777777,,777777 
@100000/ Lisl 


Errors: NO PROGRA" 
NO SUCH PAGE 
CAN'T READ THAT PAGE 
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13. Deposit into Location 
To put information into a memory location: 


@octal\address octal number% 
or 
@octal\address octal number,,octal number% 


The octal number(s) is put into the address selected. Note 
that the back slash (\) distinguishes Deposit from Examine. 
Also, with Deposit, the user must confirm with carriage 
return, | 


The number to be deposited can be written as a_ single, 
unsigned octal integer from 0 through 777777777777 (i.e., 
occupying up to the 36-bit length of a PDP-10 word). 
Alternatively, the user can specify a pair of octal integers 
to occupy the left and right halves of the word selected. 
In this case the integers can range from 0 through 777777 
(up to 18 bits). If two numbers are given, the user. can 
Separate them with a pair of commas, as shown above, or with 
a single comma, space, or altmode. The _ followin examples 
are all equivalent; in each case location 123(8) would end 
up containing: 


000001000007 


@123\1000007% 


@I23\1, , 7% 
C1273\1, 7% 
@123\1 7% 

@1Z23\1$ 7% 


Errors: NO PROGRAM 
NO SUCH PAGE 
CAN'T WRITE THAT PAGE 


14. DDT 


In addition to the two debugging commands just described, 
Tenex has a powerful interactive debugging language, DDT. 
As of 1/23/71, this language is inplemented in a_ program 
called UDDT, which occupies memory locations 770000(8) to 
777777(8) of the program being debugged. UDDT is very 
Similar to 10/50 DDT, a program written by DEC in 
conjunction with their 10/50 timesharing System, and 
documented in a DEC manual entitled DDT-10. To learn to use 
UDDT, refer to that manual along with a Tenex memo 
describing the differences between 10/50 DDT and UDDT. 
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To transfer control to UDDT: 
@DDT% 


If UDDT is not already loaded in memory with the user's 
program, the DDT command loads it and establishes 
communication to the program's symbol table as left in 
memory by LOADER. If no symbol table is found, Tenex 
provides one containing JSYS operation codes and _ other 
useful symbols. 


Errors: none 


B. FUTURE ADDITIONS 


1. Invisible DDI 


This version of DDT will be treated as a Tenex Subsystem, 
existing outside of the user's core memory, and therefore 
"invisible" to any user program. 


2. Environment (.ENV) Files and the DUMP Command 
Environment files will give tne user a mechanism for saving 
the entire state of his job for continuation in the same or 
a later session. Environment files will contain 1) the 
contents of any core memory currently assigned, 2) an 
indication of the subsystem (if any) currently in use, 3) 
any information held for the user by the monitor (for 
example temporary storage associated with a subsystem of the 
active registers of a program), 4) the status of any 
currently open file (the current location in the file, 
whether file was open for reading or writing, etc.). 


When implemented, Tenex will create Environment files 
through the DUMP command. GET will operate on Environment 
as well as Save Core files. With an Environment file, it 
will restore the user's ‘job to its state at the time the 
DUMP took place. Also , RUH, START and REENTER will operate 
on Environment’ files. If the file contained a machine 
language program, these commands will start execution in the 
Same manner as with Save Core files. Tenex subsystems also 
have starting and reentry locations, permanently built in. 
If a subsystem was in use at the time of the DUMP, RUi 
START, or REENTER will start its execution at the 
appropriate address. 
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It will be possible to interrupt a running job by +C_ prior 
to creating an Environment file. In this case, once the 
file has been reloaded (for example by GET), CONTINUE will 
restore job execution as though the interrupt had never 
happened, 


3. Concise Command Language 


The DEC 10/50 time sharing system has a special series of 
commands, separate from the ordinary monitor commands, that 
form what is known as "Concise Command Language" (CCL)*. 
Tenex will have the features of CCL implemented as built-in 
components of the Tenex executive language. 


CCL contains a number of features for file handling and 
editing that have already been implemented as _ Tenex 
commands. LIST, DIRECTORY, DELETE and RENAME are examples. 


More important for this section, CCL contains a_e series 
commands that can shorten the process of program 
compilation, loading and execution. These commands’ operate 
by interpreting the user's intent with reference to the 
files in his directory. For example, the CCL command LOAD 
takes a 10/50 file name as argument. If the user omits the 
file extension, CCL will assume he meant the most recent 
version, whether symbolic or relocatable binary file. This 
means LOAD may just load or instead compile and then load 
depending on the most recent file version. Moreover, if the 
most recent version was symbolic, LOAD will make the correct 
choice between Macro and Fortran IV depending on whether it 
encounters a .MAC or .F4 extension. Tenex will contain 
"shorthand" commands similar to those in the CCL system. 


*The CCL language was developed by William F. Weiher of 
Stanford University. 
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VIII. QUERIES 


The Tenex commands in this section answer a user's queries 
about his job, and the system resources he has in use, and 
also provide general information about the Tenex Executive 
language and the status of the Tenex system. As noted, 
certain of these commands can be given prior to logging into 
the system. 


1. The ? Feature 


In entering a Tenex command, the user can type "“?" at = any 
point where Tenex appears to expect a keyword or argument. 
Tenex will respond with a list of allowable keywords or 
description of the argument(s) expected. Typing "?" instead 
of an initial keyword will yield a ijiist of all Tenex 
commands. After an "2?" typed within a command, Tenex will 
retype the command up to that point on the next line, and 
then pause for the user to make an allowable entry. 


Examples: 


Q? 

COMMANDS ARE: 
ACCOUN 
APPEND 


USESTAT 
VERSION 
WHERE 


@AVAILABLE 2? ONE OF THE FOLLOWING: 
DEVICES 
LINES 


@GET ? FILE NAME 
GET 


2. AVAILABLE LINES/DEVICES 
To obtain a list of available teletype input lines (actually 
jacks on the Tenex input patch panel) or input/output 


devices 


@AVAILABLE LINES/DEVICES 
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Confirmation by CR is not required. The second field 
defaults to LINES. The user need not be logged in. 


Examples: 
@AVAILABLE LINES 
OU, Ty. 25 0546 5s. Os 7.10, 11. 12. 13, 14, 15, 16, 17 
20, 23, 27, 30, 31, 33, 34, 36 | 
@AVAILABLE DEVICES 
MTAO, MTAl, MTA2, MTA3, MTA4, MTAS, MTA6, MTA7, DTAO, 
DTA1, DTA2, DTA3, DTA4, DTA5, DTA6, DTA7, LPT 
The device codes above refer to magnetic tape units 0 
through 7, Dectapes 0 through 7, and the lineprinter. 
3. DAYTIME 
To obtain the date and time: 
G@DAYTIME 
Neither confirmation nor login status is required. 
Examples 
@DAYTIME 
THURSDAY, DECEMBER 3, 1970 12:34:56 
4, WHERE (IS USER) 
To find out what line(s) a user is logged in on: 
@WHERE (IS USER) user name 
Tenex will do recognition on the user name. Neither login 
nor confirmation is required. If the user in question is 
not logged in, no reply is given. If the user has one or 
more detached jobs, Tenex will type "DETACHED" along with 
any active line numbers. 
Examples: 
@WHERE (IS USER) SMITH 
TTY21 
@ 


@WHERE (IS USER) JONES 
@ 
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9. SYSTAT 


To find out how long the system has been up, who is on and 
what they are up to: 


@SYSTAT 


Neither login nor confirmation is required. Systat types 
the elapsed time since the system was last brought up, the 
number of jobs currently active and a table giving the 
Status of each active job. The job table gives the job 
number, teletype line number (or "DET" if the job is 
detached), the user name (or "NOT LOGGED IN") and the 
subsystem in uSe, 


Example: 
@SYSTAT 
UP 23:37:51] tt V0ss 


JOB TTY USER SUBSYS 
12 NOT LOGGED IN EXEC 
] JSTEGEL EXEC 
DET MYER EXEC 
25 MYER EXEC 
es: HEINTZ TECO 
BARMABY EXEC 
26 PEW TELCO?! 
46 LEAVITT RUNOFF 
ll JIC (PRIV) 
11 56 TOHLINSON EXEC 
14 27 STROLLO EXEC 
15 60 CHIPHAN WATCH 


WO TONID MO BW PO — 
nN 
> 


In the above "EXEC" means tnat a user is in communication 
with the Tenex Executive; "(PRIV)" designates a running user 
program. Line 12 has made contact witn Tenex, but not yet 
logged in. 


6. VERSION 


This command prints the Tenex System and Executive version 
numbers and date - the same information and format as is 
typed when the user first contacts Tenex with +C., This 
information should be included in all software trouble 
reports. | 
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Example: 


@VERSIONZ 
BBN-TENEX 1.16.00 10-NOV-70 EXEC 1.09 


The following commands yield information concerning the 
user's job, computer usage, and files. 


7. JOBSTAT 


To find out the TSS Job # assigned, the name of the 
logged-in user, and the teletype line: 


@JOBSTAT 
No confirmation is required. 
Example: 


@JOBSTAT 
TSS JOB 3, USER MYER, TTY25 


8. RUNSTAT 


To determine the status of a job that appears to have 
Stoppea running for some reason: 


@RUNSTAT 


No confirmation is required. Tenex will respond with a 
message indicating why the subsystem or program (if any) has 
Stopped. Possible messages include: 


NO PROGRAM 

NEVER STARTED 

4C FROM RUNNING AT pc 

4+C FROM IO WAIT AT pc 

HALT AT pc 

HALT: ILLEG inst AT pc (or other error condition) 
+C FROM FORK WAIT AT pc 

+C FROM SLEEP AT pc 


In the above, pc stands for’ the current contents of the 
program counter, V20%-% the location at which’ the 
interruption, halt, or error occurred. 


Examples: 


@RUNSTAT 
+C FROM IO WAIT AT 701220 
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Here the program was interrupted by +C while waiting for 
input or output at location 701220, 


GRUNSTAT 
NO PROGRAM 


No program or subsystem had been loaded. 


9, FILSTAT 


To find out what directory one is connected to, what files 
are open, and why, and what input/output devices one has 
assigned: 


@FILSTAT 


No confirmation is required, Tenex types the connected 
directory name (if other than the user's primary directory), 
a table of open files, and a list of assigned input/output 
devices, 


For each file, the open file table lists the Job File Number 
(JFN - see IV-E-2), the file designator, the kind of access 
the file is open for, and the current access condition. 
Access types include: 


NOT OPENED 
READ 

WRITE 

EXECUTE 

APPEND 
PROCEDURE 

PER PAGE TAELE 


Access conditions include: 


DATA ERROR 
EOF (end of file) 


For a detailed treatment of file access, see tne Tenex 
Technical Manual. 
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Example: 

@FILSTAT 

CONNECTED TO <JONES>. JFNS: 

4 ZILCH.TEL34 WRITE, EOF 

3 <SUBSYS>PA1050.SAV318 READ, EXECUTE 

2 <SUBSYS>TELCOMP.SAV;12 READ, EXECUTE 

l <SYSTEM>EXEC.SAV3;76 READ, EXECUTE 

0 <PMFDIRO>JOBPMF.;100013;T READ, WRITE, EXECUTE 


DEVICES ASSIGNED TO THIS JOB: MTA5, DTAG 


10. MEMSTAT 


This command types a report on any core memory assigned to 
the user. If none is assigned MEMSTAT types "NO PROGRAM", 
Otherwise, it types the number of assigned pages, the 
location and tlength of the entry vector, if any, anda 
memory map. The memory map gives the page number(s) for 
each assigned page or contiguous group of pages. Pages 
private to the user are designated "PRIVATE". For shared 
pages, MEMNSTAT types the name of the file or number of the 
fork that "owns" the page, and the local number of the page 
in question within the owning file or fork. Indirect page 
pointers are designated by "@".* For most pages Memstat 
types the type of access allowed: R=read, W=write, 
E=execute. 


Example: 
@MEMSTAT 
85 PAGES, ENTRY VECTOR LOC 400100 LEN 2 


0-11 PRIVATE RWE 
13-63 PRIVATE RWE 
64 PRIVATE 


400-425 <SUBSYS>TELCOMP.SAV312 12-37 RWE 
700-703 <SUBSYS>PA1050.SAV3;18 2-5 RE 


710 PRIVATE RWE 
770-774 <SUBSYS>TELCOMP.SAV312 3-7 RWE 
777 PRIVATE 


*Shared pages, forks, Ownership, and indirect page pointers 
are discussed in detail in the Tenex Technical Manual. For 
most users, the information tabulated concerning private 
pages will suffice. 
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11. USESTAT 

To find out how much CPU and console time one has used: 
@USESTAT 

No confirmation required. 

Example: 


@USESTAT 
USED 0:00:17 IW 1:12:11 


Seventeen seconds of CPU time were used during 1 hour, 
minutes, 11 seconds of connected time. 


12. DSKSTAT 


89 


12 


Types the number of disk pages occupied by all files in’ the 


currently connected directory. 
Example: 


@DSKSTAT 
76 PAGES IN USE 
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IX. TERMINAL CHARACTERISTICS COMMANDS 


These commands allow the user to communicate to Tenex the 
Salient characteristics of his terminal. 


1. Half or Full Duplex 


To inform Tenex whether one's terminal is half or full 
duplex: 


@HALFDUPLEX% 
OR 
@FULLDUPLEX% 


For an explanation of half vs. full duplex terminals, see 
ITI -Bel. These commands can be given prior to logging in. 
Unless informed otherwise, Tenex assumes full duplex 
terminals. | 


2. Other Terminal Features 


If one's terminal has built-in mechanical tab stops, a 
form-feed mechanism or lower case characters, these facts 
can be communicated to Tenex by: 


@TABS% 
@FORMFEE D% 
@LOWERCASE% 


These commands can be negated by preceding them with the 
keyword NO: 


@NO TABS% 
@NO FORMFEED? 
@NO LOWERCASE% 


Until informed otherwise, Tenex assumes the absence of tabs, 
formfeed, or lower case. With the above commands as well as 
HALFDUPLEX and FULLDUPLEX altmode is acceptable for 
termination. 


3. STOPS 


To set software tab stops for terminals Jacking a tab 
mechanism: 


@STOPS n,n... ng 


-_ 


‘ 


\ é 
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This command takes a list of decimal numbers (between 1. and 
197 inclusive), separated by commas. The numbers specify 
character positions for software tab stops. If no STOPS 
command 1S given, tab stops are every eight columns, 


Example: 


@STOPS 10,23 ,47, 80% 


Errors: "2" for argument greater than 107 


The commands above control Output from Tenex to tne user's 
terminal. For example, TABS and FORMFEED will cause Tenex 
to output these characters while NO TABS or NO FORMFEED will 
cause Tenex to simulate their action with linefeed and 
space, respectively. LOWERCASE permits Tenex to transmit 
lower case characters to a terminal, while NO LOWERCASE 
forces a conversion to upper case prior to transmission. 
The RAISE command below also affects case conversion, but 
applies to input from a terminal, rather than output to it. 


4. RAISE 


itn a dual case terminal one can type in lower case but 
have characters be received (and ecnoed) in upper case by: 


@RAISES 


This woula be useful, for example, in communicating with the 
Tenex executive, Without it one would constantly need to 
shift between upper case letters and lower case numbers, 
punctuation, etc, 


@NO RAISE% 


Turns off RAISE; characters are received anu ecnoed = as 
typed. 


Note: Unless the user is careful, LOWERCASE and RAISE can 
interact in some peculiar ways. For example, with NO 
LOWERCASE and NO RAISE in effect, and a dual case, full 
duplex terminal, lower case input will be echoed as upper 
case (due to NO LOWERCASE) but transmitted into tne - system 
as lower case (due to NO RAISE). This causes no trouble 
with Tenex commands, but might confuse a Subsystem or user 
program. 
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5. INDICATE 


To change the effect of form feed ((CTRL)-L) to merely print 
“.t" dnstead of advancing the paper to the top of the next 


page: 
@INDICATE (FORM FEED)% 


Some users prefer this mode to eliminate the blank paper 
spewed out of the terminal when running certain subsystems 
or making a listing (above). To revert to feeding paper on 
form feeds, use FORMFEED or NO FORMFEED. 
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X. FUTURE COMMAND GROUPS 


1. Input/Output Redirection 


Normally, programs and subsystems accept commands and 
parameters from and send messages to the user's teletype. 
Commands in this section will switch such input and = output 
to other devices or files. 


2. Linkage 


Tenex will permit one user to send messages to another’ by 
establishing a "Link" between his and the recipient's 
teletype. LINK (TO TERMINAL) will set up a link; BREAK 
(LINKS) will clear out any incoming or outgoing links. 
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